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Please turn to the ERRATA following the title page. 

To start up a system using MEXDS, see first page of Chapter 2. 
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Copyright 1§79 by Vector Graphic Inc. 
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Disclaimer 
Vector Graphic makes no representations or warranties with respect to the 
contents of this manual itself, v^ether or not the' product it describes is 
covered by a warranty or repair agreement. Further, Vector Graphic reserves the 
right to revise this publication and to make changes from- time to time in the 
content hereof without obligation of Vector Graphic to notify any person of such 
revision or changes, except v*ien an agreement to the contrary exists. 

Revisions 
The date of release and revision letter of each page herein appears at the 
bottom of each page. Changes from the previous revision are marked with a bar 
in the margin. The revision letter such as A or B changes if the MANUAL has 
been improved but the PRODUCT itself has not been significantly modified. The 
date of release and revision letter on the Title Page corresponds to that of the 
page most recently revised. When the product itself is modified significantly, 
the product will get a new revision number, as shown on the manual's title page, 
and the manual will revert to revision A, as if it were treating a brand new 
product. EACH MANUAL SHOULD ONLY BE USED WITH THE PRODUCT IDENTIFIED ON THE 
TITLE PAGE. 



ERRATA 



The following sheets describe the differences between the 8.4 lOOS manual 
and the 8.5 manual. The change occurs because of a very significant change to 
the system and the MDCB S^tem Disk, ^cause of printing schedules, the manual 
text is NOT modifi©3. Please make the appropriate changes in the text. The 
disk, hov^ver, is ready to use. 

Most of the differences derive fran inclusion in the system of a 64K RAM 
board v*iich provides the user with 56K of contiguous monory. (SK are not used.) 
To accomplish this, all other boards having on-board memory have been 
readdressed (Flashwriter, Disk Controller, and RROM/RiU*! boards) . Ifie Extended 
Systems Monitor has been changed to accomodate this, and the version of the 
Monitor used with the Flashwriter board has been enhanced in other ways as well. 
The MOOS operating system and utilities have also been modified as required by 
the change, and tvo new utilities added. 

Charyge the following in the manual text; 

If your system is a Systan B, the Extended Systems Monitor Executive will 
prompt the operator with "MC»I>". In other systems, the Monitor prcxnpt is still 
"*". Make this change in the text t«*ierever you find it. It appears in many 
places. 

Page Change 

1-1 The system has a 64K board, not a 48K board. The user has access to 56K of 
this. 

1-9 Change the chart as follows: 

FF40-FFFF Monitor stack area (on PROM Wm board) 

FC00-FF3F mn available to user (on PKW Em. board) ' 

F800-FBFF Disk Bootstrap RDM and Disk Controller RAM " • - ' ' ': 

F000-F7FF Flashwriter video buffer ' '; 

EC00-EFFF IK optional PROM , - 

E800-EBFF IK optional PROM 

E000-€:7FF Extended Systems Itonitor 

0000^000 56K available to user 

1-10 Top of RAM is DFFF. -, . 
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1-11 Ranove NOESCM>E, change FLASH? to FLASH8, add UPDATE-RES and WORM utilities 
(both type EC.) 

- UPDATE-RES is used to convert MDOS System Diskettes 8.4 and before into 
diskettes that can run on the Update-64 systans as the 8.5 diskette can. Simply 
put the diskette you want to update in drive (remove any write protect tab) , 
put, the 8, 5. diskette in drive 1, arrf type 1:UPDATE-RSS (return) while in the 
MDOS Executive. 

WCKM is a utility v*iich tests memory more thoroughly than any other test, 
including MDIMI. It erases all of memory, so make sure you have saved your data 
on a diskette before using it. To use, type WORM (return) while in the MDOS 
? Executive. Allow it to repeat 5 tines. It will report any errors in memory. 

2-2 N causes E000, not C000, to be displayed if the system is working properly. 

. 2-3 and 2-13 : Some systems have a Bltstreamer I board and some systems have a 
■ Bitstreamer II board. All configuration instructions in Chapter II apply to the 
Bitstrean»r.rl board. Ctonsult the Bitstreamer II manual or Vector Graphic or its 
agents for instructions on interfacing with the Bitstreamer II. Basically, it 
has 3 serial ports (2&3, 4&5, 6&7) each having a data and a status port address, 
and 2 parallel ports (8 and 9.) Centronics drivers on the 8.5 MDOS Systems 
Diskette will not work with Bitstreaner II. 

2-17 Remove section; 2.3,7. (This is because the only way now to cause a return of 
control to the Extended Systems Monitor Executive is to press the RESET button 
on the computer chassis.) 

3-3 Xhange"^ctiqn 3.7 to explains Depress RESET on the computer chassis to returt. 
control fco the Monitor Executive. Control-Q, ESC, and control-X will not work. 

3-4 Change the reference to "control-Q" to "RESET button." 

Change the title of section 3.10 to "ENTERING MDOS AND M.BASIC COMMANDS." 
CSiange the contents of the section to read "All operator entries to the MDOS and 
M.BASIC Executives can be edited with the BACK SPACE , DEL , underscore , or 
control-H keystrokes. Terminate every line by depressing the RETURN key. If 
esired, press control-T at almost any time to reverse the video image to black 
on v*iite, or back again. Some other special keys, such as the arrow keys to 
move the cursor, may affect the screen image, but do not use than v^iile in the 
MDOS or M.BASIC Executives because these keys may confuse the Executives. (Note 
that other Executives, such as the Extended Systons Monitor Executive and the 
Word Management Systan do allow use of some of these special keys.)" 

4-1 Replace "ASSM" with "ZSM." 
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REPAIR AGREEMENT 

The Vector Graphic computer sold hereunder is sold "as is", with all 
faults and without any warranty, either expressed or implied, 
including any implied warranty of fitness for intended use or 
merchantability. However, the above notwithstanding, VECTOR 
GRAPHIC, INC., will, for a period of ninety (90) days following 
delivery to customer, repair or replace any Vector Graphic computer 
that is found to contain defects in materials or workmanship, 
provided: 

1. Such defect in material or workmanship existed at the 
time the Vector Graphic computer left the VECTOR GRAPHIC, INC., 
factory? 

2. VECTOR GRAPHIC, INC., is given notice of the precise 
defect claimed within ten (10) days after its discovery? 

3. The Vector Graphic computer is promptly returned to 
VECTOR GRAPHIC, INC., at customer's expense, for examination by 
VECTOR GRAPHIC, INC., to confirm the alleged defect, and for 
subsequent repair or replacement if found to be in order. 

Repair, replacement or correction of any defects in material or 
workmanship which are discovered after expiration of the period set 
forth above will be performed by VECTOR GRAPHIC, INC, at Buyer's 
expense , provided the Vector Graphic computer is returned^ a 1 so at 
Buyer's expense, to VECTOR GRAPHIC, INC., for such repair, 
replacement or correction. In performing any repair, replacement or 
correction after expiration of the period set forth above. Buyer 
will be charged in addition to the cost of parts the then-current 
VECTOR GRAPHIC, INC., repair rate. At the present time the 
applicable rate is $35.00 for the first hour, and $18.00 per hour 
for every hour of work required thereafter. Prior to commencing any 
repair, replacement or correction of defects in material or 
workmanship discovered after expiration of the period for 
no-cost-to-Buyer repairs, VECTOR GRAPHIC, INC., will submit to Buyer 
a written estimate of the expected charges, and VECTOR GRAPHIC, 
INC., will not commence repair until such time as the written 
estimate of charges has been returned by Buyer to VECTOR GRAPHIC, 
INC., signed by duly authorized representative authorizing VECTOR 
GRAPHIC, INC., to commence with the repair work involved. VECTOR 
GRAPHIC, INC., shall have no obligation to repair, replace or 
correct any Vector Graphic computer until the written estimate has 
been returned with approval to proceed, and VECTOR GRAPHIC, INC., 
may at its option also require prepayment of the estimated repair 
charges prior to commencing work. 

Repair Agreement void if the enclosed card is not returned to VECTOR 
GRAPHIC, INC. within ten (10) days of end consumer purchase. 
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appendices 

E-1 Add remark: RES, I/O has been altered for the re-arranged board addressing. 
Hence, if you need it, list it using LINEEDIT, or assanble it using ZSM frcxn the 
8.5 MDOS System Diskette. 

H-l Bie instructions in this apperKJix only apply tx> the Bitstreaner I board. 

I-l Change C000 to E000. 

J-I Qiange FLASH? to FO»18. 

K-1 and K-2 The standard location is frcxn F800-fBFF, A single jumper at W4 is the 
standard. 

0-1 If the system has a Bitstrearner II board controlling a printer, use Bitstreamer 
base address of for serial ports at 2 and 3, and use base address 4 for' ports 
6 and 7 (to control the printer.) (Do not worry about control of a serial 
terminal, if used, "Bhis is haiK31ed by the Extended Systems "Monitor.) 

If controlling a printer out of a Bitstreamer II parallel port, then do not use 
the starxSard drivers. 

P-2 Add the following: Ports 8 and 9 are Bitstreaner II parallel ports. 40 Is 64K 
and 16K bank select. 10-14 are used by the Vector Graphic Precision Analog 
Board. "Hie Tarbell Disk uses FC as well as its other port addresses. 

Q-1 and Q-2 Change "48K" to "56K." To use the T command, enter T 0000 DFFF . . MAP 
uses scratch pad FC00 to FDFF in all systems now. Add explanation of WOm, 
taken fron the explanation above in this errata. . :' .c z , ■. 
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I GENERAL INFORMATION 

1.0 GENERAL DESCRIPTION OP SYSTEM AND SUBSYSTEMS 

Your system is a general purpose microprocessor based computer. It 
is delivered by Vector Graphic completely assembled and fully 
tested, including both hardware and operating system software, and 
including two quad density mini-floppy disk drives. 

1.0.1 STANDARD HARDWARE AND SOFTWARE 



1) Chassis with power supply and 18 slot fully shielded S-100 
motherboard; 

2) 4 MHz Z-80 CPU board; 

3) Two quad density Micropolis mini floppy disk drives, allowing 
1232 256-byte sectors per diskette. 

4) Disk controller board; 

5) Bitstreamer I/O board; 

6) 48K Dynamic RAM board; 

7) PROM/RAM III board, with space for 12K of EPROM and the 
ability to program EPROM ' s (see the PROM/RAM III board 
manual ) . 

8) The Vector Graphic Extended Systems Monitor, on PROM; 

9) Two copies of the MDOS System Diskette, each containing: , 

a) The Vector Graphic-enhanced Micropolis Disk Operating 
System - MDOS - a complete floppy diskette operating 
system, including a Z-80 Assembler, an editor, a debugger, 
and several other utilities (see Ch.4); 

b) Micropolis BASIC (see Ch. 5); 

c) A number of games and video displays (see Appendix J.) 

1.0.2 OPTIONAL COMPONENTS AND SOFTWARE 

Your MZ can be configured with various optional peripherals. 
Section 2.2 of this manual lists the configurations of printers and 
consoles considered "standard" for the MZ, and gives the components 
such as interface boards and cables needed for each configuration. 
In addition to the configurations discussed in Section 2.2, the 
following components can optionally be added to an MZ: 

1) Additional Bitstreamer I/O board(s), such as the Bitstreamer 
II having three serial ports, two parallel ports, real-time 
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clock, and Z-80 Interrupts. 

2) Additional memory board(s); 

3) Other S-100 compatible boards from Vector Graphic or other 
sources. 

4) 2 additional Mlcropolls mini-floppy disk drives; 

5) Other operating system and language software. 

Contact your dealer for more Information on adding components 
to the system. 

1.1 MICROPOLIS FLOPPY DISKETTE SUBSYSTEM SPECIFICATIONS 

1.1.1 PERFORMANCE 

Capacity per drive: 315K bytes, formatted 

Transfer rate: 250K bits/second 

Average rotational latency time: 100 milliseconds 

Access time - track-to-track : 30 milliseconds 

settling time: 10 milliseconds 

Head load time: 75 milliseconds 

Head positioner: stepper motor with lead-screw drive 

Drive motor start time: 1 second 

Rotational speed: 300 RPM 

Recording density 5248 bits per inch (BPI) 

Recording mode: MPM 

Track density: 100 tracks per inch (TPI) 

Surfaces used per diskette: 1 

1.1.2 DRIVE RELIABILITY 

MTBF 8000 hrs. 

MTTR 0.5 hrs. 

Media life 3 X 10 EXP 6 passes on single track 

Head life 10 EXP 4 hrs. 

Soft error rate 1 in 10 EXP 9 

Hard error rate 1 in 10 EXP 12 

Seek error rate 1 in 10 EXP 6 
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1.2 HEXADECIMAL NOTATION 

In this manual as in most microcomputer literature, the base 16 
number system is used for all references to memory locations, 
instruction codes, character codes, and so on. If you are not 
familiar with it, you will soon find that the hexadecimal system is 
the most natural way to express these numbers when dealing with a 
computer that stores data as groups of 8 binary digits (bits) and 
memory addresses as groups of 16 bits. Hex numbers will be 
indicated by an upper case H following the digits. Remembering a 
few key values will make things a great deal easier: 



HEX NUMBER 


DECIMAL VALUE 


JARGON 


BINARY BITS 


A 




10 






4 


B 




11 






4 


C 




12 






4 


D 




13 






4 


E 




14 


' 




4 


F 




15 






4 


10 




16 






5 


FF 




255 






8 


100 




256 






9 


3FF 


1, 


r023 






10 


400 


1, 


,024 


IK 




11 


FFP 


4< 


,095 






12 


1000 


4, 


r096 


4K 




13 


4000 


16, 


,384 


16K 




15 


8000 


32, 


,76^ 


32K 




16 


FFFF 


65, 


,535 


64K- 


•1 


16 



The familiar 
decimal: 



rules of arithmetic work just the same in hex as in 



or 



10 



40) 400 



16 



64) 1024 

11 
384 

384 



HEX (TRIVIAL) 



DECIMAL (MORE DIFFICULT) 



1.3 OPERATING SYSTEM SOFTWARE 

1.3.1 VECTOR GRAPHIC EXTENDED SYSTEMS MONITOR 

The first program the user comes into contact with after turning on 
the system is the Vector Graphic Extended Systems Monitor. 
(Exception: this is not true for MEMORITE systems.) It is entirely 
stored on non-volatile PROM. Note that this use of the term 
"Monitor" has a meaning entirely different than the term "monitor", 
which refers to a piece of hardware, namely a stand-alone video 
display. (NOTE: in the MEMORITE system, the Extended Systems 
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Monitor is not encountered unless you press the RESET key; or touch 
the ESC key while the system is under control of MDOS or another 
NON-word processing operating system. ) 

The Monitor consists of two partss first, the Extended Systems 
Monitor Executive, which allows the operator, through special 
commands, to manipulate and display memory data and to jump to some 
other program; second, a program used to control console I/O. 

You know the Extended Systems Monitor Executive is in control of the 
system when the Monitor prompt (*) appears on the left edge of the 
screen. The operator is then expected to enter one of the commands 
available for manipulating or displaying memory or jumping to 
another program. Most often, the operator will use the command 
which calls up a full operating system and then transfers control to 
it, and out of the Monitor. 

Regardless of whether executive is in control of the system at any 
given time, the Monitor console I/O routines, though invisible to 
the operator, are continually being called on to control the 
console. (Exception: when MEMORITE or the Word Management System 
are doing word processing, the Monitor is not used to control the 
console. Instead, the word processing software in these two systems 
handles this task. ) 

Some of the Monitor's features and commands are explained where 
relevent in this manual, A complete description is included as a 
separate manual with your system. 

1.3.2 PROGRAM DEVELOPMENT SOFTWARE - "PDS" 

The operating system found on the MDOS Systems Diskette included 
with the system is the Micropolis Diskette Operating System (MDOS). 
MDOS includes an assembly language program development package. 
Also found on the MDOS Systems Diskette is Micropolis Disk Extended 
BASIC (often called just M.BASIC). MDOS and M.BASIC together give 
all the functions a programmer may need for the development of 
either assembly language or BASIC programs. 

1.3.3 ELEMENTS OF MDOS 

MDOS consists of an executive program, a group of "shared" 
subroutines available to user programs as well as being used by 
MDOS, and various utilities which include assembly language program 
development tools. 

The MDOS executive program allows the user to control computer 
system operations from the system console. It provides commands for 
memory management, file management, I/O control and program 
control. 

The shared subroutines include those that provide for console and 
printer character I/O, buffered line I/O, text line parameter 
parsing, sequential and random file access, file management. 
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physical diskette access, and 16 bit interger arithmetic. There are 
also a number of processor oriented utility subroutines. 

The MDOS utilities are: 

ZSM - a two pass, 8080/8085/Z80 disk to disk assembler program. 

LINEEDIT - a line number oriented assembly language text editor with 
character-within-line editing and global search and change 
capabilities. 

FILECOPY - a utility that copies disk files. 

DISKCOPY - a utility that makes an exact copy of an entire 
diskette. 

SYMSAVE - a utility that creates a source file of symbol equate 
statements from the symbol table left in memory immediately after an 
assembly by the ZSM assembler. 

DEBUG - a utility that facilitates checkout and debugging of 
8080/8085 machine language programs. It cannot be used if Z80 code 
which is not part of the 8080 set is used. 

1.3.4 ELEMENTS OF M.BASIC 

M.BASIC is a complete, self-contained software package that provides 
total support for BASIC programming. When M.BASIC is loaded you 
have at hand a powerful set of tools for developing, testing, 
executing and maintaining BASIC programs. 

Program lines may be as long as 250 characters in length and may 
include multiple statements. The maximum line number is 65529.' 

M.BASIC has 12 immediate mode commands, including; SAVE a file, 
LOAD a file, DISPLAY the file directory, SCRATCH a file, LIST a 
program, DELETE lines from a program, RUN a program, CNTL/C to 
interrupt a running program, CONT to continue an interrupted 
program, CNTL/U to cancel an input line, and FLOW and NOFLOW to 
enable and disable the flow trace debugging aid. 

M.BASIC supports 6 distinct data types, including integers, integer 
arrays, floating point numbers in the range lE-61 to 1E62-1, string 
arrays, floating point arrays, and character strings up to 250 
characters long. Integer and floating point arrays may have up to 4 
dimensions. String arrays may have up to 3 dimensions plus a length 
parameter. 

A unique SIZES statement enables you to select the precision of 
numeric variables up to 60 digits for simple arithmetic and 20 
digits for transcendental functions. The system defaults to 8 
digits for real numbers and 6 for integers. 

M.BASIC supports numeric operators for addition, subtraction, 
multiplication, division, integer division, and exponentiation. 
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There are relational operators to compare numbers or strings and the 
logical operators AND, OR, and NOT, String concatenation is also 
available. 

Numeric functions include ABS, ATN, COS, EXP, FIX, FRAC, INT, LN, 
LOG, MAX, MIN, MOD, RND, SGN, SQR, and TAN. 

String functions include ASC, CHAR$, FMT, INDEX, LEFT$, LEN, MID$ , 
MAX, MIN, REPEAT$, RIGHT$ , STR$ , VAL, VERIFY. 

The unique FMT {X,Y$} function is the key to a powerful formatted 
output capability. It returns a string which is the value of X 
formatted per the image defined by format string Y$. 

The DEF FN statement is provided to allow construction of user 
defined functions. An assembly language function may be accessed by 
using the DEF FA construction. 

Standard statements in BASIC include CHAIN, DATA, DEF, DIM, EDIT, 
END, EXEC, FOR-NEXT-STEP, GOSUB, GOTO, IF-THEN, INPOT, LET, MEMEND , 
MERGE, NOFLOW, FLOW, ON-GOTO, ON-GOSOB, OUT, PLOADG, POKE, PRINT, 
READ, REM, RENUM, RESTORE, RETURN, SIZES, STOP, and STRING. 

The CHAIN is a true chain that passes variables from the current 
program segment to next one loaded from disk. 

EXEC is a unique statement that allows a string variable or constant 
to be executed as if it were a predefined program line. 

Data file programming in M.BASIC is simple. Piles can be opened 
simultaneously for both sequential and direct (random) access in 
both read and write modes. Dp to 10 files can be open at one time. 
A CLEAR option allows a file to be opened for rewrite instead of 
append. An END option provides an on-endf ile-goto capability. An 
ERROR option provides an on-error-goto capability. 

Data is written to and read from files using GET and PUT statements 
with variable lists that allow a mixture of numeric and string 
variables. 

The file I/O structure also extends to printer and console output 
files to afford a high degree of device independence. Additional 
options on the OPEN statement facilitate the pagination of output 

reports. 

Also provided is a BASIC Utility program that provides for 
initializing diskettes, saving M.BASIC on a BASIC-only diskette, and 
examining and changing RAM memory. In addition, there is a utility 
called FEATURES which allows you to shorten M.BASIC by eliminating 
some of the features needed only for program development, but not 
for running production programs. 

1.3.5 OTHER OPERATING SYSTEMS 

Other operating systems and higher level languages are available 
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from Vector Graphic. These will not be discussed here. (See the 
literature accompanying this manual.) MDOS and M. BASIC meet the 
needs of the large majority of users. 

1.3.6 RESIDENT PROGRAMS 

MDOS and M.BASIC share the Extended Systems Monitor. They also 
share a common program module called RES. This module contains 
among other routines, the printer and diskette I/O routines, and 
some of the console I/O routines. 

Also shared is the ROM resident Disk Bootstrap program, (which is 
what the Monitor uses in order to call up MDOS), and the Disk 
Controller, (which is simply memory space needec3 to handle the 
diskette drives.) 

These routines are always resident in the computer memory when 
either MDOS or M.BASIC is running. For interested users, listings 
will be found in Appendix E for the I/O portion of RES, Appendix F 
for the Disk Bootstrap program, and the Extended Systems Monitor 
manual for the Monitor. 

In contrast, MDOS and M.BASIC overlay each other; that is, they are 
assigned the same area of memory; only one can be in memory at any 
given time. Commands are provided for leaving one and calling up 
the other. 

Fig. 1.1 illustrates the relationships between the various system 
programs. Programs which are always in memory when MDOS or M.BASIC 
is used are in the center. 

Fig. 1.2 gives the addresses of the various programs and important 
memory locations in your system. No particular operating system is 
shown. 

Fig. 1.3 gives addresses for MDOS and M. BASIC. Note that this 
operating system software fits into the unassigned memory area in 
F ig . 1 . 2 . 



Rev. 8.1 2/5/79 1-7 



FIGURE 1.1 MZ SOFTWARE STRUCTURE USING MDOS 
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Hex address Contents 

FFFF 



EOOO 
DF40 
DCOO 

D^O 
0800 

DOOQ 
OCOO 
C800 
C400 

COOO 



8000 



8K RAM for user's programs, optional; 

OR 
High Resolution Video board, optional; 

OR 
Jfefflorite PKDM's, optional. 



PR-2 stack area, not available to user. 



RAM available to user. 



Disk controller - first 3 bytes are addresses 
used for raem. mapped disk I/O. Remaining are 
unusable. 



Disk Bootstrap RDM. 



Plashwriter board video buffer, c^tional. 



MenK>rite configuration PRCM, optional. 



EVI03 PRDM, optional. 



MZCS PRDM, optional. 



ExteraSed Systans Monitor, including console 
I/O routines. 



48K RAM, available to user. 



0000 



Rev. 8.1 2/5/79 



1-9 



FIG 1.3 MEMOffi MM* EDR MDOS MD M. BASIC 

Hex address Contents 

BFFF 



2B00 if MDOS 
5700 to 

5D86 if BftSIC 



1593 



/T* 



RM menory for user's progran 



Starting point depends en whether MDOS or M. BASIC 
is being used, and Aether BASIC has been shortened. 



1598 
0627 
0613 
0611 
060F 
0604 
0600 
05F8 
04E7 
02B1 
OlAO 



mm 

006A 

0000 



MDOS, including all user callable routines not in RES Module? 
.OR ^ 

M. BASIC Interpreter. 



RES MXULE 

End of RES Module. 

LDOtfT - Physical List Output Routine. 

LDINIT - Physical List Initialization. 

LDAOiN - Kiysical List Attention Chedc Routine. 

CDINIT - Physical Console Initialization. 

OBRK - Hiysical Break Check Routine. 

CDCXIT -- Hiysical Console Output Routine. 

COIN - Hiysical Console Input Routine. 

MDCB or M. BASIC ^oraistart (entry) location. 

Spinning of RES Module code. 

Beginning of RES Itoiile input buffer. 



MXS system stack, and used by Boot loader. 



RAM available to user. 
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1.4 MDOS SYSTEM DISKETTE 



This revision of the User's Guide to Vector Graphics Systems Using 
MDOS corresponds to MDOS System Diskette 8.4, (and minor revisions 
of it labeled 8.4.1, 8.4.2, etc.) Following is a list of the files 
on this diskette: 

(Under TYPE, "EC" means the file is stored in executable machine 
language code and It will be executed immediately if you type its 
name after the MDOS prompt. "AL" means the file is stored in 
assembly language source code. You must first assemble it using ZSM 
before it can be executed by the computer. "B" means the file is 
stored in the M.BASIC language. It will be executed by using the 
M.BASIC Interpreter explained in chapter 5«) 



NAME 



DESCRIPTION 



TYPE 



DIR 
RES 



MDOS 

BASIC 
LINEEDIT 
ZSM 
SYMSAVE 

PILECOPY 
DISKCOPY 
COPYFILE 

DEBUG-GEN 

FEATURES 



The disk directory. 

Machine language routines used by both MDOS > 

and M.BASIC Do not delete It unless you 

are modifying It. 
MDOS executive and disk I/O routines. 

Do not delete this. See Appendix B 

to create a BASIC-only diskette. 
M.BASIC Interpreter and disk I/O. EC 

See Chapter 5» 
Line editor for writing assembly language. EC 

programs. See Section 4.4. 
Assembler of Z-80 code prepared in extended EC 

8080 mnemonics. See Section 4.5. 
Utility which creates a source file EC 

of equate statements using the symbol 

table resulting from an assembly. 

See Section 4.6. Used occasionally by 

assembly language programmers. 
Utility for copying a file from one drive EC 

to another. See Secton 4.7. Used often. 
Utility for copying a disk from one drive to EG 

another. See Section 4.8. Used often. 
Utility for copying a file from one disk to EC 

another, using the SAME drive, for systems 

having only one drive. See Section 4,10. 
Utility used to generate the DEBUG utility EC 

residing In a particular portion of 

memory. See Section 4.11. 
Utility used to shorten BASIC. EC 

See Appendix G. 
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NAME 



DESCRIPTION 



TYPE 



SYSQl, and 
SYSQ2 



UTILITY 
RES. I/O 



DIAB 



DIAB4 
CENT 
CENT 4 
DEGW 

DECW4 
SAYERES 



NOESCAPE 

MDIAG 
MAP 

PLASH7 

PROM 

STARTREKQ 

CI7ILWAR 

LUNAR 

FINANCE 



B 



AL 



EC 



Assembly language source code containing the AL 

names of all MDOS shared subroutines, 

equated to their addresses. Used 

in assembly language programs calling those 

routines. See Section 4.3. Used from time 

to time by assembly language programmers. 
A utility used to initialize diskettes, create 

BASIC -only diskettes, and examine memory. 

See Appendix B. 
The source code file of the I/O routines in 

RES. Used to rewrite the I/O routines if 

using non-standard peripherals. 

See Appendices M, N, and 0. 
Routine for interfacing to Diablo-protocol 

printers if the Bitstreamer board is 

addressed for ports - $• Overlays 

directly over RES In memory. 

See Section 2.2.2. Not 

needed after RES is saved on diskette. 
Same as DIAB, but Bitstreamer is at 4 - 7. 
Same as DIAB, but for Centronics printers. 
Same as CENT, but Bitstreamer is at 4 - ?• 
Same as DIAB, but for teletype-protocol 

printers. 
Same as DEC¥, but Bitstreamer is at 4 - 7* 
Utility used to save on disk the machine 

language version of the I/O portion of the 

RES Module. See Section 2.2.0. Not 

needed after the RES Module is finalized. 
Utility which stops the ESC key from causing 

control to be passed to the Systems Monitor. 

See Section 2. 3* 7- Not needed after used 

once. 
Utility used to check the computer's memory. 

See Appendix Q. Do not delete this. 
Utility which tells what kind of memory 

(RAM, ROM or nothing) is in the system 

at each address. See Appendix Q. 

Useful when servicing a system. 
Demonstration of the graphics capability of 

the Plashwrlter II board. See Appendix J. 

Dealers use often. 
Utility used with the PROM/RAM III board to 

program EPROM's. See PROM/RAM III manual. 
The Star Trek game. See Appendix J. 

Dealers use often. Others if they like it. 
Another game. See Appendix J. 
Another game. See Appendix J. 
Day-to-day financial calculations. 
See Appendix J. Used often if you need it. 



EC 
EC 
EC 
EC 

EC 



EC 



EC 



EC 



EC 



EC 
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To obtain a list of the files on your diskette, to see what is 
actually there, turn the machine on, mount the system diskette in 
drive (right-hand drive) , type B after the Monitor prompt (*) , 
type FILES after the MDOS prompt (51, and then press the RETURN key. 
The interaction looks like this on the screen: 

*B 

Vector MZ MDOS X.XX 

> FILES 

DIR 03 0000 

RES 03 0014 



The left-hand number refers to the file type, explained in Section 
4.2.3. The right-hand number gives the length of the file in 
sectors. Both numbers are in hexadecimal (base 16). 

The list is long and will roll past the edge of the screen. To stop 
it at any point, depress controI-S ( CTRL key and S at the same 
time.) To start it up again, depress the spacebar . 

If you have a printer which is up and r\jnning with your system, you 
can print the directory by typing ASSIGN 2, 3 (return) , before you 
^yP^ FILES . After the directory is printed, type ASSIGN 2 , 2 
(return) to turn the printer off again, "(retxirn)" means press the 
RETURN key. 
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II INSTRMATION, CONFIGURING PERIPHERALS, AND USE OF DISKETTES 

2.1 INSTALLATION 

For turn-key systems (that is, all internal wiring and software 
modifications have been done prior to delivery), just plug in 
external cables to the sockets on the rear panel of the mainframe. 
End users: if sockets are not labeled and choice is not obvious, ask 

your dealer. 

For non-turn-key systems, refer to Section 2.2 for directions on 

setting up peripherals, interface boards, cables, and interface 
software. For systems with which a printer will be used, it may be 
desirable to first set the system up as if there were no printer, 
test it as explained below, then complete the setting up procedures 
for the printer. Section 2.2 separates the 2 stages. 

When ready to test the system, do as follows: 

1. Turn the power key on the front panel and then turn on 
peripherals. The Monitor prompt * should appear on the 
screen. (Exception: in MIMORITE systems, depress RESET on 
the front panel after turning the power on. The Monitor 
prompt should then appear.) 

2. Enter N on the keyboard. This is a memory test which also 
functions as a test of the console. After a few seconds a 
hexadecimal number should appear. It indicates the first 
memory address where no memory hardware is located. In 
normal systems with 48K of RAM, the number should be COOO. 

3. Insert and mount the MDOS Personalized System Diskette in 
drive 0. Drive is the right-hand drive. The left-^hand 
drive is drive 1. Refer to Section 2.4 for how to insert, 
mount, and in general handle diskettes. 

4. Enter B. This causes MDOS to be loaded and take control. 
This will be indicated by the MDOS sign on message and the 
MDOS prompt: >. 

5. To test a separate printer, if any, first make sure there is 
paper in the printer. Then, enter ASSIGN 2,3 (return) , 
followed by FILES (return) . (The expression (return) always 

means "press the RETURN key."). A list of the files on the 
System Diskette will be printed. 

When the system is working properly, refer to Chapter 3 for a 
complete description of normal operating procedures, and to Section 
2.4 for instructions on the handling and maintenance of diskettes. 
Do not neglect either Section 2.4 or Chapter 3 as they contain 
information which is not effectively acquired by trial and error 
alone. Section 2.3 describes various modifications which can be 
made to the hardware. 
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alone. Section 2.3 describes various modifications which can be 
made to the hardware and systems software. 



2.2 CONFIGURING THE MZ ~ TEIS SECTION FOfi NON-TURN-KEY SYSTEMS OHLY 

2.2.0 MODIFYING THE RES MODULE 

At various points in this chapter (or in related appendices) you 
will be instructed to carry out procedures which modify the RES 
Module. The most common of such procedures are the Software 
Implementation Procedures found In section 2.2.1 under each of the 
standard configurations. (These Software Implementation Procedures 
are used only If a printer Is Implemented.) 

To carry out any procedure which modifies the RES Module, turn the 
system and all^ peripherals on. In MEMORITE systems, depress the 
RESET button next. Then Insert and mount the Personalized MDOS 
System Diskette in drive 0. Do not use the Master MDOS System 
Diskette. This diskette should never be altered and only used for 
emergency back-up. After the Monitor prompts with *, enter B. This 
"boots up" MDOS, as Indicated by the MDOS sign-on message and MDOS 
prompt: >. Now proceed with the given procedure. 

Note that in all software procedures, "(return)" means "press the 
RETURN key." 

The user may be instructed to enter a command, such as DIAB4 
(return) . Whenever such a command is entered, the system will 
respond by displaying the MDOS sign-on message again, or at least 
the MDOS prompt >. 

A step will be found which commands "Save the RES Module on 
Personalized System Diskette." This Is accomplished as follows: 
Make sure the Personalized MDOS System Diskette is Inserted and 
mounted in drive 0. Then under MDOS type SAVERES (return) . .The 
drive should write on the diskette. The RES Module is now saved on 
the Personalized MDOS System Diskette. 

Important: You may want to do several different procedures, each of 
which terminates with saving the RES Module. You are definitely 
free to do any group of them at one sitting, and then save the RES 
Module as described above ONCE at the end of the session, in order 
to save trouble. Alternately, you may of course save the RES Module 
after each such procedure, if desired. 

Note: SAVERES is a utility which saves on diskette the I/O portion 
of the RES Module, in machine language form. The block of code 
which is saved corresponds to the code found in the source listing 
called RES. I/O, plus a few bytes before and after. In the rare case 
you have modified the RES Module outside of the I/O portion, then 
you must use the following alternate steps to save the RES Module: 
Under MDOS, enter TYPE "RES" d) (return) SCRATCH "RES" (return) SAVE 
"RES" 2B1 1598 3 (return). 
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2.2.1 STANDARD CONFIGURATIONS 

At this time, Vector Graphic supplies the interface hardware and 
software to support several different configurations of main 
peripheral devices, that is, printers, keyboards, video displays, 
and terminals. This section is concerned with identifying these 
standard configurations, and explaining how they are implemented. 

If the peripheral device desired is not found among the standard 
configurations, refer to Section 2.2.3. 

The information is collected in the following pages. Each section 
is concerned with one configuration. Each configuration is a 
selected group of peripherals. Peripherals are listed as generic 
types, (upper case lettering). Specific makes are given as examples, 
(lower case lettering). The user is not limited to these examples, 
but can use any model that falls within the given generic 
description. 

To use these charts, find the configuration desired. When ordering 
an MZ or other Vector Graphic computer, order it with the components 
listed as well as the peripherals desired if supplied by Vector 
Graphic. (Since all systems are always delivered with one 
Bitstreamer board and an I/O cable, do not explicity order these 
items.) 

If no printer is being used, find the desired configuration ignoring 
the type of printer listed. For this purpose, refer only to those 
configurations whose, headings are NOT preceded by asterisks (*) . 
Then, only order the parts and carry out the steps shown WITHOUT 
asterisks. 

If a printer is being added to an existing system, find the desired 
configuration, then only order the parts and carry out the steps 
shown WITH an asterisk (*) . To obtain a useful summary of the 
issues involved with printers, see seciton 2.2.2 

Some systems may already be partially configured at the factory or 
by intermediaries, so that you need order and set up only the 
components not already included. For example, "System B" is an MZ 
with the Vector Graphic Mindless Terminal and Flashwriter II board. 
All you have to add is a printer. Your choices would be the 
configurations in Sections 2.2.1.4 and 2.2.1.6 for Centronics or 
Diablo-type printers respectively. MEMORITE is even simpler than a 
System B. Just do the Software Implementation procedure in Section 
2.2.1.6, us ing the DIAB4 command . 

Flashwriter Board: The charts refer to a "Flashwriter Board." 
Order a Flashwriter I for 16 x 64 display and Flashwriter II for 80 
X 24 display. When ordering an Extended Systems Monitor for use 
with one of these boards, always state which it is for. 

Wien your system and/or components are delivered, refer again to the 
chart. Perform the implementation procedures listed in order to 
implement the desired configuration. 
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* 2.2.1.1 Printer; PARALLSL, CENTRONICS 700 SERIES PROTOCOL. 
Console: SERIAL VIDEO TERMINAL. 

Examples Parallel Centronics matrix printer (700 Series), and 

Hazeltine terminal. 

Interface Components Required 

1. Option C Extended Systems Monitor, on PROM. 

* 2, Centronics interfacing kit 

3. Bitstreamer board and I/O cable (no need to order; 
included in system automatically.) 

Hardware Implementation Procedures 

* 1. Install the Centronics interfacing kit as instructed in 

Appendix H. Make sure there is an I/O cable connected at 
one end to J3 on the Bitstreamer board and at the other 
end installed in one of the cutouts at the rear of the 

mainframe. 

2. Plug the external terminal cable into the socket on the 
rear of the mainframe which is wired to the 6 pin molex 
connector on the Bitstreamer board. 

* 3. Plug the printer cable into the socket which is wired to 

J3 on the Bitstreamer board. 

Software Implementation Procedures 

* 1. Under J4D0S, enter CENT (return) . 

* 2. Save RES Module on Personalized System Diskette. 

2.2.1.2 Printer; SERIAL, DIABLO 1610 OR TELETYPE PROTOCOL. 
Console; SERIAL VIDEO TERMINAL. 

Example: Printer: if Diablo protocol - Diablo 1610 or 1620, 
Qume Sprint 5, or NEC Spinwriter; if Teletype protocol - 
Decwriter, Teletype, or TI 810 or 820. 
Console: Hazeltine terminal. 

Interface Components Required 

1. Option C Extended Systems Monitor, on PROM 

2, Bitstreamer board and I/O cable (no need to order; 
included in system automaticelly. ) 

* 3. A second Bitstreamer board 

* 4. A second I/O cable 

Hardware Implementation Procedures 

* 1. Jumper one of the Bitstreamer boards so that it is 

readdressed for ports 4-7 rather than the original - 
1. Instructions will be found in the Bitstreamer User's 
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Manual. This board will be used to control the printer. 

* 2. Make sure that the printer Is set for its highest speed, 

(1200 baud for Diablo 1610 protocol), and that its parity 
setting is MARK parity. Check the printer manual if 
necessary. Some printers such as the Diablo require a 
jumper on internal circuitry to increase from 300 baud to 
1200 baud. 

* 3. Make sure that the Bitstreamer board is set for the same 

speed as the printer. This is set on a dipswitch on the 

upper left-hand corner of the board. Press the 
appropriate switch in and upward and make sure all other 
sSitches are pressed downward. 

4. Connect one of the I/O cables to J3 on one of the 
Bitstreamer boards. Install the 25 pin socket on the 
other end of the cable in a cutout at the rear of the 
mainframe. 

* 5. Do step 4 for the second Bitstreamer and I/O cable. 

* 6. Plug the printer cable into the socket connected to the 

readdressed Bitstreamer. 

7. Plug the terminal cable into the socket connected to the 
normal Bitstreamer. IMPORTANT: Some terminals will not 
operate if they are connected to all 25 pins, because some 
of the pins of J3 on the Bitstreamer have functions other 
than serial communications. If your terminal does not 
operate after connecting it to all pins, then connect only 
the essential ones. Example: the Hazeltine 1400 will 
function only if a 3-line cable is used, connect ing , pins 
2,3, and 7. A 25 pin ribbon connector will not work. 
Other terminals may require additional pins, but again not 
all 25, Refer to the Bitstreamer board manual if 
necessary for definitions of each of the pins on the 
- backpanel connector. 

Software Implementation Procedures 

* 1. Under MDOS, if printer uses Diablo protocol, enter DIAB4 

(return) ; if printer uses Teletype protocol, enter DECW4 
(return) . 

* 2. Save RES Module on Personalized System Diskette. 
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* 2.2.1.3 Printer; PARALLEL, CENTRONICS 700 SERIES PROTOCOL 

Console; PARALLEL ASCII KEYBOARD, SEPARATE VIDEO MONITOR. 

Example: Printer: Parallel Centronics matrix printer (Series 700) 

Console: Vector Graphic stand-alone parallel keyboard and 
Hitachi video monitor. 

Interface Components Required 

1. Option EV Extended Systems Monitor on PROM 

2. Flashwriter board 

3. I/O cable 

4. Video cable, for Flashwriter to rear panel 

5. Video monitor to mainframe cable 

* 6. Centronics interface kit 

* 7. Bitstreamer board with I/O cable (no need to order; 

included in system automatically.) 



Hardware Implementation Procedures 

* 1. Jumper the Bitstreamer board so that it is readdressed for 

ports 4-7 rather than the original 0-1. Instructions 
will be found in the Bitstreamer User's Manual. 

* 2. Install the Centronics interfacing kit as instructed in 

Appendix H. However, do not install the 6 pin molex 
. connector or the serial I/O cable which come in the 
Centronics interface kit. They are not needed and can be 
set aside. Make sure that there is a regular I/O cable 
connected to J3 on the Bitstreamer board and installed at 
the other end in a cutout at the rear of the mainframe. 
This socket will be used for the printer cable. 

3. Connect the 2 pin socket at one end of the video cable to 
the 2 left-most pins which will be found rising vertically 
from the left-hand corner of the Flashwriter board. The 
socket should be positioned so that the inside wire is 
connected to pin 1, and the-outside "shield" wire is 
connected to pin 2 (ground). Install the circular socket 
at the other end of the cable into one of the circular 
cutouts at the rear of the mainframe. 

4. Connect the 24 pin dip plug at one end of the second I/O 
cable to Jl on the Flashwriter board. Install the 25 pin 
socket at the other end in one of the cutouts at the rear 
of the mainframe. This socket will be for the keyboard 
cable. 

* 5. Plug the printer cable into the appropriate sockets on the 

rear of the mainframe. 

6. Plug the external keyboard and monitor cables into the 
appropriate sockets on the rear of the mainframe. 



2-6 



Rev. 8.1 2/5/79 



Software Installation Procedures 

* 1. Under MDOS, enter CENT4 (return) . 

* 2. Save RES module on Personalized System Diskette. 

* 2.2.1.4 Printer; PARALLEL/ CENTRONICS SERIES 700 PROTOCOL. 
Console: VECTOR GRAPHIC MINDLESS TERMINAL. 

Example: Parallel Centronics matrix printer (Series 700) and Vector 
Graphic Mindless Terminal. 

Interface Components Required 

1. Option EV Extended Systems Monitor on PROM 

2. Flashwriter board 

3. Mindless Terminal 3-part I/O cable 

4. External Mindless Terminal cable (or equivalent) 

* 5. Centronics interface kit 

* 6. Bitstreamer board with I/O cable (no need to order; 

included in system automatically.) 

Hardware Implementation Procedures 

* 1. Jumper the Bitstreamer board so that it is readdressed for 

ports 4-7 rather than the, original 0-1. Instructions 
will be found in the Bitstreamer User's Manual. 

* 2. Install the Centronics interfacing kit as instructed in 

Appendix H. However, do not install the 6 pin molex 
connector or the serial (3 wire) I/O cable which come in 
the Centronics interface kit. They are not needed and can 
be set aside. Make sure that there is a regular I/O cable 
connected to J3 on the Bitstreamer board and installed at 
the other end in a cutout at the rear of the mainframe. 
This socket will be used for the printer cable. 

3. If not already done at the factory, install the Mindless 
Terminal 3-part I/O cable as instructed in the terminal's 
documentation. The 3 parts are connected to the power 
supply, the Flashwriter board video output pins, and the 
Flashwriter board keyboard input socket (Jl). At the 
other end, the DB25 socket is installed in one of the 
cutouts at the rear of the mainframe. 

* 4. Plug the printer external cable into the respective 

socket at the rear of the mainframe. 

5. Plug the terminal external cable into the respective 
socket at the rear of the mainframe. 

Software Installation Procedures 

* 1. Under MDOS, enter CENT4 (return). 
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* 2. Save RES module on Personalized System 
Diskette, 

2.2.1.5 Printer; SERIAL, DIABLO 1610 or TELETYPE PROTOCOL 

Console: PARALLEL ASCII KEYBOARD, SEPARATE VIDEO MONITOR. 

Example: Printer: if Diablo protocol - Diablo 1610 or 1620, 
Qume Sprint 5, or NEC Spinwriter; if Teletype protocol - 
Decwriter, Teletype, or TI 810 or 820. 

Console: a Vector Graphic stand-alone parallel 
keyboard and Hitachi video monitor. 

Interface Components Required 

1. Option EV Extended Systems Monitor on PROM 

2. Flashwriter board 

3 . I/O cable 

4. Video cable, Flashwriter to rear panel 

5. Video monitor to mainframe cable 

* 6. Bitstreamer board with I/O cable (no need to order; 

included in system automatically.) 

Hardware Implementation Procedures 

1. If no printer is being used, remove the Bitstreamer 

from the mainframe, and do not put it back in. It cannot 
be in the system (unless readdressed as explained below.) 

* 2. Jumper the Bitstreamer board so that it is readdressed for 

ports 4-7 rather than the original 0-1. Instructions 
will be found in the Bitstreamer User's Manual. 

* 3. Make sure that the printer is set for its highest speed, 

(1200 baud for Diablo 1610 protocol), and that its parity 
setting is MARK parity. Check the printer manual if 
necessary. Some printers such as the Diablo require a 
jumper on internal circuitry to increase from 300 baud to 
1200 baud. 

* 4. Make sure that the Bitstreamer board is set for the same 

speed as the printer. This is set on a dipswitch on the 
upper left-hand corner of the board. Press the 
appropriate switch in and upward and make sure all other 
switches are pressed downward. 

* 5. Make sure that there is a regular I/O cable connected to 

J3 on the Bitstreamer board and installed at the other end 
in a cutout at the rear of the mainframe. This socket 
will be used for the printer cable. 

6. Connect the 2 pin socket at one end of the video cable to 
the 2 left-most pins which will be found rising vertically 
from the left-hand corner of the Flashwriter board. 
Install the circular socket at the other end of the cable 
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into one of the circular cutouts at the rear of the 

mainframe. 

7. Connect the 24 pin dip plug at one end of the second I/O 
cable to Jl on the Flashwriter board. Install the 25 pin 
socket at the other end in one of the cutouts at the rear 
of the mainframe. This socket will be for the keyboard 
cable. 

* 8. Plug the printer external cable into the appropriate 

socket on the rear of the mainframe. 

9. Plug the keyboard and monitor external cables in the 
appropriate sockets on the rear of the mainframe. 

Software Installation Procedures 

* 1. Under MDOS, if printer uses Diablo protocol, enter DIAB4 

(return); if printer uses Teletype protocol, enter DECW4 
(return) . 

* 2. Save RES module on Personalized System Diskette 

2.2.1.6 Printer; SERIAL, DIABLO 1610 or TELETYPE PROTOCOL. 

Console; VECTOR GRAPHIC MINDLESS TERMINAL. 

Example: Printer: if Diablo protocol - Diablo 1610 or 1620, Qume 
Sprint 5, or NEC Sprinwriter; if Teletype protocol - Decwriter, 
Teletype, or TI 810 or 820. 

Console: Vector Graphic Mindless Terminal. 

Interface Components Required 

1. Option EV Extended Systems Monitor on PROM 

2. Flashwriter board 

3. Mindless Terminal 3-part I/O cable 

4. External Mindless Terminal cable (or equivalent) 

* 5. Bitstreamer board with I/O cable (no need to order; 

included in system automatically. ) 

Hardware Implementation Procedures 

1. If no printer is being used, remove the Bitstreamer from 
the mainframe. Do not put it back in. It cannot be in 
the system. 

* 2. Jumper the Bitstreamer board so that it is readdressed for 

ports 4-7 rather than the original 0-1. Instructions 
will be found in the Bitstreamer User's Manual. 

* 2. Make sure that the printer is set for its highest speed, 

(1200 baud for Diablo 1610 protocol), and that its parity 
setting is MARK parity. Check the printer manual if 
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necessary. Some printers such as the Diablo require a 
jumper on internal circuitry to increase from 300 baud to 
1200 baud. 

* 4. Make sure that the Bitstreamer board is set for the same 

speed as the printer. This is set on a dipswitch on the 
upper left-hand corner of the board. Press the 
appropriate switch in and upward and make sure all other 
switches are pressed downward. 

* 5. Make sure that there is a regular I/O cable connected to 

J3 on the Bitstreamer board and installed at the other end 
in a cutout at the rear of the mainframe. This socket 
will be used for the printer cable. 

6. If not already done at the factory, install the Mindless 
Terminal 3-part I/O cable as instructed in the terminal's 
documentation. The 3 parts are connected to the power 
supply, the Flashwriter board video output pins, and the 
Flashwriter board keyboard input socket (Jl). At the 
other end, the DB25 socket is installed in one of the 
cutouts at the rear of the mainframe. 

* 7. Plug the printer external cable into the respective socket 

at the rear of the mainframe. 

8, Plug the terminal external cable into its socket at the 

rear of the , mainframe . 

Software Installation Procedures 

* 1. Under MDOS, if printer uses Diablo protocol, enter DIAB4 

(return) ; if printer uses Teletype protocol, enter DECW4 
(return) . 

* 2. Save RES module on Personalized System Diskette. 

* 2.2.1.7 SERIAL PRINTING TERMINAL (HAS A KEYBOARD), DIABLO 1610 
OR TELE TYPE PROTOCOL 
AND A VIDEO MONITOR " 

Example: Printing terminal: if Diablo protocol - Diablo 1620, Qume 
Sprint 5 with keyboard, or NEC Sprinwriter with keyboardi if 
Teletype protocol - Decwriter, Teletype, or TI 810 or 820, with 
keyboards; 

Video monitor: Hitachi. 

Interface Components Required 

1. Option CV Extended Systems Monitor on PROM 

2. Flashwriter board 

3. Video cable, Flashwriter to rear panel 

4. Video Monitor to Mainframe cable 

* 5. Bitstreamer board with I/O cable (no need to order; 

included in system automatically.) 
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Hardware Implementation Procedures 

* 1, Make sure that the printer is set for its highest speed, 

{1200 baud for Diablo 1610 protocol), and that its parity 
setting is MARK parity. Check the printer manual if 
necessary. Some printers such as the Diablo require a 
jumper on internal circuitry to increase from 300 baud to 
1200 baud. 

* 2. Make sure that the Bitstreamer board is set for the same 

speed as the printer. This is set on a dipswitch on the 
upper left-hand corner of the board. Press the 
appropriate switch in and upward and make sure all other 
switches are pressed downward. 

* 3, Make sure that there is a regular I/O cable connected to 

J3 on the Bitstreamer board and installed at the other end 
in a cutout at the rear of the mainframe. This socket 
will be used for the printer cable. 

* 4. Disable the parallel port on the Flashwriter board. To do 

this, simply remove chip U52 from the board, using a small 
screw driver to pry it out of its socket. If U52 cannot 

be easily located, refer to the Flashwriter User's 
Manual. 

5. -. Connect the 2 pin socket at one end of the video cable to 
the 2 left-most pins which will be found rising vertically 
from the left-hand corner of the Flashwriter board. The 
socket should be positioned so that the inside wire is 
connected to pin 1, and the outside "shield" wire is 
connected to pin 2 (ground). Install the circular socket 
at the other end of the cable into one of the circular 
cutouts at the rear of the mainframe. 

* 6. Plug the printer external cable into the socket on the 

rear of the mainframe. 

7. Plug the monitor external cable into the appropriate 
socket on the rear of the mainframe. 

Software Installation Procedures 

* 1. Under MDOS, if printer uses Diablo protocol, enter DIAB 

(return) ; if printer used Teletype protocol, enter DECW 
(return) . 

* 2. Save RES module on Personalized Diskette. 
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* 2.2.1.8 SERIAL PRINTING TERMINAL (HAS KEYBOARD), DIABLO 1610 
OR TE LETYPE PROTOCOL 

m vs&so. 

Example: Printing terminal: if Diablo protocol - Diablo 1620, Qume 
Sprint 5 with keyboard, or NEC Sprinwriter with keyboard; if 
Teletype protocol - Decwriter, Teletype, or TI 810 or 8 20, with 
keyboards; 

Interface Components Required 

1. Option C Extended Systems Monitor on PROM 

* 2. Bitstreamer board with I/O cable (no need to order; 

included in system automatically.) 

Hardware Implementation Procedures 

* 1. Make sure that the printer is set for its highest speed, 

(1200 baud for Diablo 1610 protocol), and that its parity 
setting is MARK parity. Check the printer manual if 
necessary. Some printers such as the Diablo require a 
jumper on internal circuitry to increase from 30 baud to 
1200 baud. 

* 2, Make sure that the Bitstreamer board is set for the same 

speed as the printer. This is set on a dipswitch on the 
upper left-hand corner of the board. Press the 
appropriate switch in and upward and make sure all other 
switches are pressed downward. 

* 3. Make sure that there is a regular I/O cable connected to 

J3 on the Bitstreamer board and installed at the other end 
in a cutout at the rear of the mainframe. This socket 
will be used for the printer cable. 

* 4. Plug the printer cable into the socket at the rear of the 

mainframe. 

Software Implementation Procedures 

* 1. Under MDOS, if printer uses Diablo protocol, enter DIAB 

(return) ; if printer uses Teletype protocol, enter DECW 
(return) . 

* 2. Save RES Module on Personalized System Diskette. 

* 3. If printer uses Diablo protocol, then before each session 

at the computer, as the first step after loading MDOS, 

enter: 

ASSIGN 2,3 (return) 
ASSIGN 1,0 (return) 



(Do not be concerned that while entering the second line, 
the printer prints every character twice.) 
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NOTE: Using the serial Diablo protocol printing terminals at 1200 
baud with no video display is limited by the fact that no Extended 
Systems Monitor commands which cause outputing more than about 40 
characters can be used. (This is because serial output from the 
Extended Systems Monitor does not use the Diablo protocol technique 
of checking whether the printer can accept the next character. More 
than 40 characters at 1200 baud will usually cause the printer's 
buffer to overflow.) MDOS and M.BASIC commands do not cause the 
same problem, so long as the above mentioned ASSIGN commands are 
used prior to each session. 

One way to solve this problem is to run the printer at 300 baud 
(Bitstreamer at 300 baud too) and to use the DECW command rather 
than the DIAB command before saving the RES module on the 
Personalized System Diskette. In this case, the ASSIGN commands are 
not needed. The drawback is slower printing. 



2.2.2 ADDING A STANDARD PRINTER TO AN EXISTING SYSTEM 

The information in this section concerns adding a printer to an 
existing system, one which already has some kind of video display 
and keyboard functioning. The logic behind this information is the 
same as that used in section 2.2.1, except that here it is presented 
in summary form. : 

The printers presently considered standard for Vector Graphic 

systems are: 

Centronics Series 700 parallel matrix printers, 

Diablo 1610 protocol serial printers, such as Diablo 1610, Qume 

Sprint 5, or NEC Sprinwriter, and 
Teletype protocol printers, such as Decwriter, Teletype, or TI 

810 and 820. 

There are many makes and models with protocols similar or identical 
to the above. Some differences between makes of printers will not 
make them incompatible with the Vector Graphic computers 
necessarily, but it is recommended that the user try out with his 
system any printer not listed above, before purchasing. 

Adding a printer involves 3 steps: 

1) obtain the interface components, as well as the printer, 

2) do hardware implementation procedures required, and 

3) do software implementation procedures required. 

INTERFACE COMPONENTS REQDIRED 

1) Bitstreamer board and I/O cable. Generally, use the one which 
came with your system. If it is being used to control a serial 
terminal now, it can be used in addition to control a parallel 

printer such as a Centronics printer. However, if the present 
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terminal is serial, and a SERIAL printer such as Diablo, Qume, or 

Teletype is desired, a second Bitstreamer and I/O cable must be 
ordered. 

2) If a parallel Centronics protocol printer is to be implemented, 
order a CENTRONICS INTERFACE KIT from Vector Graphic or an 
authorized dealer. 

HARDWARE IMPLEMENTATION 

1) If the keyboard and video are controlled by a Flashwriter board, 
or if both the printer and the video console are serial, then there 
will be 2 interface boards in the system. When this is the case, 
the Bitstreamer controlling the printer must be jumpered to respond 
to port addresses 4-7 rather than 0-1. Instructions will be 
found in the Bitstreamer User's Manual. 

2) If the printer is a parallel printer using Centronics protocol, 
make the modifications to the Bitstreamer board and install the 
Centronics Interface Kit, both as described in Appendix H. Do all 
the procedures in Appendix H if the keyboard and video are a serial 
terminal such as Hazeltine. However, if the keyboard and video are 
controlled by a Flashwriter board, then do not bother to install the 
6-pin plug or the serial I/O cable. 

3) If printer is serial, make sure it is set at its highest speed 
(1200 baud if it is Diablo 1610 protocol.) Then make sure the 
dipswitch on the upper left-hand corner of the Bitstreamer is set at 
the same rate (chosen switch up, all others down.) Printer must be 
set for MASK parity. 

4) Make sure the the 24 pin dip plug on the I/O cable is inserted in 
J3 on the Bitstreamer board and that the socket on the other end is 
installed in one of the cutouts on the mainframe back panel. Then 
plug the printer cable into that same socket on the back panel. 

SOFTWARE IMPLEMENTATION 

The RES Module on the MDOS System Diskettes is not configured for 
any particular printer. However, a large number of versions of the 
I/O portion of the RES Module are present on the diskettes. The 
user need only overlay the desired version onto the RES Module 
stored in memory, and then save the new RES Module onto the 
Personalized System Diskette. The versions available as of this 
release are: 

CENT and CENT4 for parallel Centronics protocol printers 
DIAB and DIAB4 for serial Diablo protocol printers 

DECW and DECW4 for serial Teletype protocol printers 

In each case, the version with a "4" attached must be used if the 
Bitstreamer has been readdressed for ports 4-7. Otherwise use the 
version without a "4". 
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To accomplish the overlay, simply enter the name of the file in 
upper case letters following the MDOS prompt >. After the overlay is 
done, indicated by another MDOS sign-on message appearing on the 
screen, save the RES Module by entering the following commands under 
MDOS: 

TYPE "RES" (return) 



SCRATCH "RES" (return) 

SAVE "RES" 2B8 146B 3 (return) 

If the printer is not one of the above types, then a custom 
interface routine must be written. See Appendix N. 

2.2.3 NON-STANDARD CONFIGURATIONS 

Any configuration of peripherals which includes a printer, video 
unit, keyboard, or terminal different than those used in the 
standard configurations, is a non-standard configuration. 

Hardware: In order to order and implement the interface hardware, 
use the standard configuration procedures as models as far as is 
possible. 

Software: In many non-standard configurations, it will be necessary 
to custom write a printer and/or console physical I/O routine, refer 
to Appendix M for rewriting console I/O and to Appendix N for 
rewriting printer I/O.. 



2.3 MODIFYING THE SYSTEM HARDWARE 

2.3.1 CHANGING TO 2 MHZ CLOCK RATE 

Some non-Vector Graphic S-100 boards operate only at 2 MHz, the rate 
of the original 8080 clock. Since the Z-80 can operate at both 
rates, you may desire to run the system at 2 MHz in order to include 
such boards. Instructions will be found in Appendix L. 



2.3.2 CONNECTING ADDTIONAL DISK DRIVES 

2 Micropolis disk drives are standard equipment. Additional drives 
may be added because the Micropolis software can addresss up tp 4 
drives. Contact your dealer or Vector Graphic in order to order. 
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2.4 DISKETTE MEDIA 



2.4.1 DESCRIPTION 



The recording medium used with the MZ Micropolis diskette subsystem 
is an industry standard 5 1/4-inch diskette (Fig 2.1) in its 
hard-sectored version with 16 sectors, each defined by a sector 
hole. Thus, it has one index hole and 16 sector holes. Diskettes 
of this type are available from computer stores or from other 
computer supply sources. DO NOT USE DISKETTES WITH OTHER THAN 16 
HARD SECTORS, OR THOSE WHICH ARE SOFT-SECTORED (NO SECTOR HOLES). 
THEY WILL NOT WORK. 

2.4.2 HANDLING 

1) The Micropolis flexible disk drive subsystem was designed to 
take every reasonable precaution to protect your diskettes and the 
data recorded on them. Examples of this care are the door interlock 
which prevents mounting of the diskette until it is properly 
Inserted, and the automatic 5 second deselect feature which relieves 
the head load pressure from the recording surface when the drive is 
not in use. 

Once the diskette is removed from the drive, it is your 
responsibility to exercise the same care in handling and storing the 
diskette to ensure its long service life. The following precautions 
are guidelines for proper handling: 

a) The exposed recording surface is easily contaminated - do 
not touch or attempt to clean the surface. Do not smoke, eat or 
drink while handling the diskette. Whenever the diskette is removed 
from the drive, return it to its protective envelope. 

b) The diskette is a thin oxide-coated plastic sheet which may 
be damaged if handled carelessly. Do not place heavy objects on the 
diskette? do not expose the diskette to excessive heat or sunlight; 
do not use rubber bands or paper clips on the diskette; do not bend 

or fold the diskette. 

c) Do not write on the diskette labels with an erasable 
pencil: graphite particles may contaminate the diskette or it may 
be damaged by the force exerted in writing. A fiber-tip type of pen 
is recommended. Return the diskette to its envelope before writing 

on labels. 

d) Information is recorded on the diskette as magnetized 
"spots". Exposure of the diskette to magnetic fields or 
ferromagnetic objects which may become magnetized may result in the 
loss of information. 

If a diskette is damaged or contaminated it should be replaced. If 

a contaminated diskette is placed in the drive, the receiver and 
read/write head may become contaminated and ruin other diskettes. 

2) The auto-deselect will ensure reasonable diskette life. But, as 
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a rule you should unmount the diskette whenever it is not going to 
be accessed for long periods of time. This will give added diskette 
life and prolong the life of the drive motor. 

2.4.3 LOADING AND UNLOADING 



There are two stages of loading a diskette. First, insert the 
diskette with label side upward for horizontal drives, or leftward 
for vertical drives, and with the edge nearest to the read/write 
head access hole going in first. Insert the diskette all the way, 
until it clicks into place. At this point the diskette is said to 
be "inserted" but not yet "mounted". The diskette may be left like 
this for any length of time without decreasing its life. Power may 
be turned on or off with the diskette in this condition. It is 
recommended however that if a diskette will not be used for any 
length of time it be returned to its envelope or other storage 

Second, the diskette is "mounted" by depressing the manual load 
actuater on the disk drive slowly but firmly until it stays in the 
mounted position. The drive will begin to turn and rotate the 
diskette inside its jacket. If the load actuator cannot be fully 
depressed, this indicates that the diskette was not inserted 
completely or properly. 

Power should NOT be turned on or off when a diskette is in the 
mounted position. The consequence is from time to time the loss of 

data on the diskette. 

Once the diskette is mounted, it is accessible by software for 
writing or reading. When a read or write operation is initiated, 
you will hear an audible click from the drive unit and the red light 
on the unit will glow, indicating that unit has been selected. 
After the operation is complete, the unit will remain selected for 5 
seconds. At the end of 5 seconds, the unit will be automatically 
deselected: the red light will go out, and there will be another 
click as the head load pad is raised off the surface of the 
diskette. This automatic deselect feature is important in 
lengthening the life-span of diskettes. 

To dismount the diskette, press the load actuator down as far as it 
will go, then release pressure. It will then open to the unmounted 
position. This discontinues rotation of the diskette within its 
jacket. In order to do your part as user in prolonging the life of 
the diskette, observe the following rule: UNLOAD THE DISKETTE DURING 
PERIODS IN WHICH IT IS NOT IN USE, This reduces wear of the 
diskette against its jacket. Note that the diskette may be left 
inserted, so long as it is unmounted, without shortening its life. 

To remove the diskette, press the load activator upward (or leftward 
in vertical drives). The diskette will be popped out (de-inserted) 
and can now be removed. 
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2.4.4 REPLACEMENT AND SACK-UP OF DISKETTES 

The nature of floppy diskette drives is that the read-write head is 
in contact with the diskette surface whenever the unit is selected, 
resulting in gradual deterioration of the surface. Continual 
loading of the head on a single track will naturally result in its 
deterioration before the rest of the diskette. The rotation of the 
diskette within its jacket is an additional source of wear. 

Backup: The BEST defense against loss of diskette-based data is 
maintaining a back-up diskette for each diskette you use. In the 
business world, this is considered dogma. Data is most often lost 
due to damage to diskettes from accidental mis-handling; normal wear 
is much less often a problem. The standard rule of thumb is as 
follows: copy a front-line diskette on to its back-up whenever you 
cannot afford to lose the information stored since you last backed 
it up. This goes for programs as well as data. If you are 
operating business programs such as inventory or accounts 
receivable, maintain a regular back-up schedule, once a week or once 
bi-weekly. In addition, your programs if possible should be written 
so that an internal file of entries is maintained, and a printout of 
entries made each day is produced. Then, if data is lost before it 
can be copied on to the back-up, it is fairly easy to re-enter it, 
using the back-up diskette as the starting point. In business 
particularly, back-up diskettes and printouts of daily entries 
should be stored in a safe place. 

Replacement: In addition to being backed up, frequently used 
diskettes must be replaced from time to time. The intervals are 
entirely dependent on the kind of usage. There are no accurate 
predictions for diskette life-span, but 2000 to 3000 hours of 
rotation is a reasonable estimate. A good suggestion therefore is 
to replace such diskettes every 6 months. Data diskettes , used 
infrequently may never require replacement. 

Failure of a diskette will be indicated by the inability of the 
system to read a file which it normally has been able to read. MDOS 
will report "PERM I/O ERROR". With proper care, this should not 
occur. 

Replacing a diskette simply means copying it onto a new previously 
unused diskette. The old diskette can be used for temporary 
storage, or disposed of. 

To copy diskettes use the Diskcopy Utility, see Section 4.3. 
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2.4 DISKETTE MEDIA 



2.4.1 DESCRIPTION 

Use an industry standard 5 1/4-inch diskette (Fig 2.1) with 16 
"hard" sectors. There will be 16 sector holes and 1 additional 
index hole around the edge of the center hole. Get them from 
computer stores or from other computer supply sources. DO NOT USE 
DISKETTES WITH OTHER THAN 16 HARD SECTORS, OR THOSE WHICH ARE 
SOFT- SECTORED (NO SECTOR HOLES) . THEY WILL NOT WORK. 

Without relation to price, some brands of diskettes do not work well 
in the Micropolis high-density drives. Use one of the following 
brands: Scotch, Dysan, or Maxell. Other brands will not be 
reliable. 

Individual diskettes may sometimes not work. Besides manufacturing 
defects, we have occasionally found batches of diskettes with the 
wrong number or sectors, and sometimes diskettes are manufactured 
with 2 diskettes inside the jacket. Diskettes which do not work or 
do not work reliably should be replaced immediately. 

2.4.2 IF YOU HAVE PROBLEMS WITH DISK ERRORS 

By a disk error, we are referring to errors reported on the screen 
as "PERM I/O ERROR", indicating something wrong with the diskette or 
drive. (The message is different in different operating systems. 
Another uses "CRC ERROR".) If your system generates such errors 
often with different diskettes, take the following measures in the 
order given: 

a) Make sure the ocver to the mainfram is on. It is a 
shield. 

b) Switch to another of the sxiggested brands of diskettes. 

c) If the errors persist, contact your dealer or service 
representative . 

2.4.3 HANDLING 

Diskettes are easily damaged and contaminated. Please obey the 
following rules without exception: 

a) Do not touch or attempt to clean the inner surface. 

b) Do not smoke, eat, or drink while handling the diskette. 

c) Do not place heavy objects on the diskette. 

d) Do not expose the diskette to excessive heat or sunlight. 
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e) Do not use rubber bands or paper clips on the diskette. 

f) Do not bend or fold the diskette. 

g) Do not write on a diskette with a pencil. A fiber-tipped 
pen is recommended. Return the diskette to its envelope before 
writing on it. 

h) Do not expose the diskette to magnetic fields. 

1) After use, always return a diskette to its protective 
envelope or other protective system such as plastic notebook pages 
designed for diskettes. 

j) Store diskettes in a vertical position, thus reducing 
rubbing. 

k) If a diskette is damaged or contaminated, replace it. If a 
contaminated diskette is placed in the drive, the receiver and 
read/write head may become contaminated and ruin other diskettes. 

1) Unmount the diskette if it will not be accessed for a half 
hour or more. If the Interval is very long, remove it from the 
drive and return it to its storage envelope. 



2.4.4 LOADING AND UNLOADING 

There are two stages of loading a diskette. First, Insert the 
diskette with label side leftward, with the edge nearest the exposed 
area pointing Inward. Insert the diskette until it clicks into 
place. You should not have to push so hard that the diskette bends. 
The diskette is now "inserted" but not yet "mounted". Although not 
good practice for long periods, you may leave the diskette like this 
any length of time, and even ttim power on or off. 

Second, to "mount" the diskette, push the door of the drive until 
you feel increased resistence about ' half -way closed, then SLOW DOWN, 
and push SLCWLY but surely until it stays in the mounted position. 
The drive will begin to turn and rotate the diskette inside its 
jacket. If you cannot fully close the door, the diskette is not 
Inserted properly. 

Do NOT turn power on or off while a diskette is in the mounted 
position. This will sometimes damage the diskette. However, if you 
accidently do this, go ahead and use the diskette because it is 
probably undamaged. 

Once the diskette is mounted, it is accessible by software for 
writing or reading. When the computer accesses the diskette, you 
will hear a click from the drive and its red light will glow. After 
the operation is complete, the drive will remain on for 5 seconds. 
You can be entering new material at the keyboard during this time. 
At the end of 5 seconds, the red light will go out, and there will 
be another click as the head load pad Is raised off the surface of 



2-20 Rev. 8.3-A 7/1/79 



the diskette. This automatic deselect feature is imporant in 

lengthening the life-span of diskettes. 

To dismount the diskette, press the door further open as far as it 
will go, then let it close. It will then release to the unmounted 
position. This stops the rotation of the diskette. UNMOUNT THE 
DISKETTE DURING PERIODS IN WHICH IT IS NOT IN USE. This reduces 
wear of the diskette against its jacket. You may leave it inserted 
wi though shortening lifespan. 

To remove a diskette, press the door lefward. The diskette will pop 
out. 

2.4.5 RECOVERY TECHNIQUES 

If you repatedly get PERM I/O erros using one particular diskette, 
then it is probably defective. This will sometimes happen with a 
new diskette when you are initializing it or copying another 
diskette to it. After several attempts, discard it or return it if 
possible. Whenever you repeat a disk operation after an error, 
always unload and reload the diskette, because it may be seated 
incorrectly. 

If an old diskette repeatedly gives errors, first repeat the 
operation several times, xmloading and reloading the diskette each 
time. If there is still a problem, check the center hole. If it is 
wrinkled, straighten it out with your fingers and then try again. 
If you still get errors, try copying the diskette to another 
diskette using the DISKCOPY utility in MDOS. If the error still 
occurs, try switching source and destination drives. Some 
combination of drives and repositioning of diskettes within drives 
will almost always result in a successful copy. If you cannot copy 
a diskette at all, then copy it file by file to another initialized 
diskette using the MDOS COPYFILE utility. There will probably be 
one file ^ich does not copy, but If you are lucky, they will all be 
good. 

2.4.6 REPLACEMENT AND BACK-UP OF DISKETTES 

As with any magnetic storage medium, the recording gradually 
deterioreates over time. Even if a diskette is not damaged, it will 
begin producing errors after sufficient use. 

Backup: The BEST defense against loss of diskette-based data is 
maintaining a back-up diskette for each diskette you use. In the 
business world, this is considered dogma. Copy a diskette on to its 
back-up whenever you cannot afford to lose the infomation stored 
since you last backed it up. This goes for programs as well as 
data. If you are operating business programs such as inventory or 
accounts receivable, maintain a regular back-up schedule, once a 
week or once bi-weekly. In addition, a transaction journal - that 
is a printed copy of entries made each day into the system - is an 
excellent idea to build into business software as a last resort 
back-up. 
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Replacanent: In addition to being backed up, replace frequently used 
diskettes by copying to a fresh diskette every 6 months. A good 
suggestion is to use the back-up diskette, which is fairly fresh, as 
the new front-line diskette, and to create a fresh back-up. Do not 
wait until a frequently used diskette fails , before you replace it 
with the back-up. 

To copy diskettes, use the DISKCOPY utility. See Section 4.3 

2.4.7 INITIALIZING DISKETTES 

Previously unused diskettes must be initialized (also called 
"formatted ) before use. There are two routines in the Micropolis 
software that can do this. Use either the INIT command in MDOS (see 
4.1.5.22) or the F command in the BASIC UTILITY program operating 
under M.BASIC, (see Appendix B) . Their results are identical. DO 
NOT INITIALIZE THE MDOS SYSTEM DISKETTES PROVIDED WITH THE SYSTEM, 
OR ANY OTHER DISKETTE CONTAINING DESIRED INFORMATION. THIS DESTROYS 
THEIR CONTENTS. 

2.4.8 WRITE PROTECT FOR DISKETTES 

Write protect tabs come in boxes of new diskettes. If you attach a 
tab over the write protect cutout on a diskette as shown in Fig. 2.2 
the disk drive will not allow you to erase or change any information 
on the diskette. The tab may be removed later. 
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WRITE ENABLE NOTCH 



WRITE PROTECT TAB 
FOLD OVER SIDE OF DISK 




INDEX AND 

SECTOR HOLE 



WRITE PROTECT TAB IN PLACE 




Figure 2.2 How To Mount Write Protect Tab 
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Ill DAY TO DAY OPERATIONS FOR MDOS AND M.BASIC 

3.0 SUMMARY OP NORMAL START UP PROCEDURE 

1) Powep-on the mainframe, then the peripherals. 

2) If yours Is a MEMORITE system, depress RESET key. 

3) Insert and mount MDOS System diskette In drive 0. 

4) Enter B on keyboard. MDOS comes on. 

5) Enter BASIC (return) on keyboard. M.BASIC comes on. 

(return) means press the RETURN key. 

Please read the rest of this, chapter thoroughly. The above does not 
give all the Information you need. 

3.1 SUMMARY OP PROMPTS 

When one of these prompts appears. It indicates the corresponding 
system is loaded and its executive routine is waiting for operator 
Input . 

1) * Monitor 

2) > MDOS 

3) READY M.BASIC 

3.2 POWER-ON 

1) No diskette may be in mounted position, (i.e. rotating) 
but it may be inserted in drive. 

2) Turn the power key on the mainframe. The RESET button 
will light up. 

3) If yours is a MEMORITE system, depress the RESET button. 

4) Switch on all desired peripherals. 

5) Depress RESET on printer, if printer will be used and if 
printer has one. 

6) An asterisk and cursor will appear on the console 
indicating the Extended Systems Monitor executive is 
available for commands. A few Monitor commands are 
covered in this chapter. The remaining will be found in 
the Extended Systems Monitor manual. Look it over. Some 
may be useful. Monitor commands can be entered at this 
time or at any other time that the Monitor executive is 
called back into control. Indicated by the Monitor prompt 
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3.3 LOAD MDOS 

1) Insert, if not done already, and mounc an MDOS Syscem 
diskette in drive 0. In place of the MDOS System 
diskette, you may substitute an M.BASIC-only diskette. 

2) Enter B^. MDOS will be loaded into memory and control will 

be transferred to the MDOS executive. The screen will 
look like this: 

*B 

Vector MZ MDOS X.XX 

> 

You may now enter MDOS commands (Chapter 4) . 

If MDOS should come up but does not, refer to Appendix I for 
troubleshooting. 

If a M.BASIC-only diskette was in drive 0, the screen will look like 
this: 

•*B 

MICROPOLIS BASIC VS. X.X. -COPYRIGHT 1 9XX 

READY 

In this case, you may begin entering M.BASIC commands iimnediately 
(chapter 5) and skip Section 3.4. Section 2.3.6 discusses 
BASIC-only diskettes, 

3.4 LOAD M. BASIC FROM MDOS 

You may work in MDOS for some time and then transfer control to 
M.BASIC, or you may desire to go immediately to M, BASIC as your 
first MDOS command. In either case, enter BASIC (return) . The 
screen will appear like this: 

> BASIC 

MICROPOLIS BASIC VS. X.X. -COPYRIGHT 1 9XX 

READY 

You may now enter M.BASIC commands. (Chapter 5). 

3.5 OTHER OPERATING SYSTEMS AND LANGUAGES 

This manual deals primarily with the MDOS operating system, as it is 
normally delivered. For commands in other operating systems, 
including how to load their associated BASIC'S or other languages, 
refer to the manuals for those systems, included if and when they 

are ordered. 
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3.6 RETURNING TO MDOS FROM M.BASIC 

1) Make sure there is a System diskette with MDOS mounted in 
drive 0. 

2) Enter LINK "MDOS" (return) . (See Section 5.21.2.7 for how 
LINK works and for other uses of LINK command) . 

3) Screen will look like this: 

READY 

LINK "MDOS" 

Vector MZ MDOS X.XX 

> 

You may now enter MDOS commands. 

To return to M.BASIC, enter BASIC (return) as usual (see Section 
3.4.) 

3.7 RETURNING TO MONITOR FROM ANYPLACE 

1 ) Depress control-Q (hold CTRL key down while depressing Q) ; 
or press the RESET key on the mainframe front panel. 
Control-Q is preferred. 

2) You may now enter Extended System Monitor commands. 

NOTE: For systems without the version 3.1 Systems Monitor, 
control-Q will not work when you try it. If you find this 
to be the case, then either the ESC key or control-X WILL 
work instead. To find out which will work in your system, 
get MDOS running and try them. Control-X and the ESC key 
each have a special function in the MDOS and M.BASIC 
editors. If one of these causes a return to the Monitor, 
then obviously, you cannot use that fimction in the MDOS 
and M.BASIC editors. Make a mental note of this when 
reading the MDOS and M.BASIC editor instructions. If ESC 
or control-X causes a return to the Monitor instead of 
control-Q then substitute it wherever control-Q appears in 
this chapter. 

Retirrning to the Monitor is useful when Monitor commands are needed 
for trouble-shooting MDOS or M.BASIC programs. It is also used if 
there is no other way to break out of an undesired loop or output 
sequence in any program. Always use control-Q rather than RESET if 
possible, because on extremely rare occasions, RESET may change some 
of the contents of memory. 

Control-Q will not work when certain special purpose programs are 
operating. The most important of these are disk access routines, 
and the Word Management System and MEMORITE word processing 
software. RESET is necessary in these cases if you want to return 
to the Monitor. 
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Avoid using RESET to abort a disk write operation, if possible, 
because if at that moment the directory is being written, then all 
the data on the disk can be effectively lost. (The same holds true 
if you dismount the disk at that time.) 

In addition, aborting a disk read or write operation may leave the 
file in an "open" state, which can cause an error message next time 
the drive is accessed. This can be cleared by executing the FILES 
command in MDOS. Enter FILES (return) , then return to your program 
and access the disk. 

The best advice is, in general, allow disk read and write operations 
to go to their natxiral conclusions. Only abort if the operation is 
looping indefinitely. 

3.8 RETURNING TO MDOS (OR M.BASIC) FROM MONITOR IF MDOS (OR M.BASIC) 

IS ALREADY IN MEMORY 

This is the MDOS (or M.BASIC) warm-start command. 
Depress J after the Monitor prompts with *. 

3.9 RETURNING TO MDOS OR M.BASIC EXECUTIVE FROM WITHIN A ROUTINE 
RUNNING UNDER THAT EXECUTIVE 

Depress control-C . (Hold the CTRL key down while depressing C. 

Response is MDOS prompt (>) if MDOS is the executive, or BASIC 
prompt (READY) if BASIC is the executive. 

Control-C is used to leave a routine at other than the normal end 
point. Use it when the routine is waiting for any type of keyboard 

input. It is sometimes also effective for interrupting an overly 
long or unending stream of output. 

If it does not work, then control-Q is the alternative. Since this 
returns control to the Monitor, depress J then to return to MDOS or 
M.BASIC. 

3.10 VIDEO COMMANDS 

This section is ONLY relevent to systems using memory mapped video, 
such as the Vector Graphic Mindless Terminal. If a serial terminal 
such as Hazeltine is used, then refer to the manual for that 
terminal to find how you can control the screen image from the 
keyboard. 

These commands may also not work if another operating system, such 
as CP/M is in control of the system. They will definitely not work 
when word processing, using the Word Management System or MEMORITE, 
is in control. 

Most of the time, when the system is waiting for keyboard input, 
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operator may perform the following operations on the screen image. 
These commands are made possible by the Extended Systems Monitor. 
For more information of a technical nature, refer to the Extended 
Systems Monitor manual. 

3.10.1 CLEAR SCREEN 
Depress control-D . 

3.10.2 SCROLL SCREEN UP ONE LINE 
Depress control- J or LF key. 

3.10.3 BACKSPACE CURSOR 

Depress BACKSPACE key, underscore key, or control-H . Also, the DEL 
key will have this effect IF MDOS or M. BASIC is rtinning . 

These commands will always work when MDOS or M.BASIC executives are 
waiting for input, and when any M.BASIC program is waiting for 
input . 

In other situations, for example, ^en an assembly language program 
is waiting for input, these commands may or may not work depending 
on how the program in control was written. 

3.10.4 CONVERT THE SYSTEM TO REVERSE VIDEO 

For variation, you. can cause the screen to display characters 
black -on-white rather than white- on-black. Just depress contr,ol-T 
(hold down CTRL key while depressing T ) If you depress this again, 
the vid4o will return to white-on-black. Characters already entered 

will remain on the screen the way they were entered. 

3.10.5 TAB CURSOR TO NEXT TAB LOCATION (EVERY 8 SPACES) 
Depress TAB key or control-I 

3.10.6 ELIMINATE CURSOR FROM THE SCREEN 
Depress control-N 

3.10.7 MOVE CURSOR TO TOP OF SCREEN 
Depress control-B 
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3.10.8 MOVE CURSOR DOWN, UP, LEFT, OR RIGHT 

Depress one of the keys with an arrow on it. If your keyboard has 
no arrow keys, then depress control-R , control-U , control-W , or 
control-Z to move cursor dowrTJ up, Teft"^ or right respectiveTy . 
However, Control-U and the up-arrow key will not work under while in 
MDOS or M.BASIC, though it will work under certain machine language 
programs and when in the Extended Systems Monitor echo mode (Y 
command) . 

3.10.9 RETURN CURSOR TO LEFT EDGE OP SCREEN 
Depress RETURN key or control-M. 



3.11 POWER-DOWN 



1. Make sure you have stored on diskette all the programs and 
data you wish to save. 

2. Dismount all diskettes. They may be left inserted and 
clicked in, so long as they are not mounted (rotating). 

3. Turn off all peripherals. 

4. Turn the power key on the mainframe front panel. 



Rev. 8.4-A 7/26/79 3-6 



IV MICROPOLIS DISKETTE OPERATING SYSTEM 



4.0 INTRODUCTION TO MDOS 

MicropoHs Program Development Software consists of two systems, 
Micropolis BASIC which 1s discussed 1n Chapter V and the Micropolis 
Diskette Operating System (MOOS). MDOS consists of an executive 
program, a group of shared subroutines available to user programs, 
and an assembly language program development package. 

The MDOS executive program impletients an interactive coranand language 
that allows the user to control computer system operations from the 
system console. It provides commands for menory management, file 
management, I/O control and program control. 

MDOS contains a very large group of subroutines which can be called 
from a user's application program. These subroutines provide for 
console and printer character I/O, buffered line I/O, text line 
parameter parsing, sequential and random file access, file managenent, 
physical diskette access, and 16 bit integer arithmetic. There are 
also a number of processor oriented utility subroutines. 

Six application programs make up the package that supports assembly 
language program development. LINEEDIT facilitates the creation of 
source files. ASSM is a two pass 8080/8085 disk to disk assanbler. 
SYMSAVE creates a source file of equate statements from a latent 
symbol table. FILECOPY is a utility for copying named files. OISKCOPY 
is a utility for making literal copies of an entire diskette. DEBUG 
provides facilities to locate and correct program bug's in machine 
language programs. 
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4.1 THE MDOS EXECUTIVE 

The MOOS extcutive program implements an Interactive command language 

that allows the operation of the microcomputer system to be controlled 

from the system console. When fIDOS is loaded it signs on with the 

message 

MICROPOLIS MOOS VS. X.X - COPYRIGHT 1978 

> 

It is then waiting for an executive statement to be entered. 

4.1.1 ENTERING EXECUTIVE COMMANDS 

Executive statements are entered by typing characters in sequence on 
the console keyboard. An executive statanent is terminated by pressing 
the RETURN key. During the entry of a statement each character that is 
typed is echoed by the executive on the console display. Two control 
features may be used when entering a line. 

1) when DEL or RUBOUT key is pressed the next previously typed 
character will be deleted from the line. A backarrow is echoed 
to the terminal display for each character deleted. 

2} Holding down the control key and typing X (CNTL/X) will cause 
all of the current line to be cancelled. A carriage return line 
feed -combination is echoed to the terminal display. The 
executive is positioned to accept entry of a new line. 

4.1.2 EXECUTIVE STATEMENT FORMAT 

An executive statement has the following form: 

Cunit:]NAHE C"<ASCn>" '•<ASCn>" ... "<ASCII>" <hex> <hex> ... <hex>] 

The NAME in an executive statement may be the name of an explicit command 
or the name of a disk file. MDOS has 23 explicit commands which are 
discussed in this section. Explicit command names are uppercase only 
and must not be preceded by any spaces. In addition, executable assembly 
language programs can be loaded into memory and run by entering their 
file NAME. This provides an implicit command capability that can be used 
to extend the executives vocabulary. Implicit command filenames can be 
up to ten ASCII characters in the code range 21 hex to 7E hex. Imbeded 
spaces, double quotes, backarrows, and rubouts are not allowed in 
implicit coiwnand filenames. 

When an executive statement is entered the executive program searches 
its table of explicit command names for a match with the NAME that was 
input. If the NAME is found iq the table of command names the statement 
is executed immediately. If the NAME is not an explicit conmand name, 
then the NAME is treated as an implicit command filename which must be 
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found on disk. Implicit coimiand filenames may be prefixed by an optional 
unit number. This specifies the disk drive on which the NAMEd file is to 
be found. If no unit number is specified, unit is assumed. If a unit 
number is specified it must be separated from the first character of the 
NAME by a colon (:). The executive processes the implicit conroand filename 
by searching the directory of the specified disk drive for the file. If 
the file is found on the disk (and the file type is correct) the executive 
loads the program file into memory and transfers control, along with any 
parameters in the executive statement, to the program. If the executive 
does not find the file on the specified drive an error message is. output 
to the console stream: COMMAND NOT FOUND. If the file is found on the 
disk but it is not an executable file an error message is output to the 
console stream: WRONG FILt TYPE. See the section on file type definitions 
for a detailed discussion of file types. 

Executive statements consist of a NAME followed by parameters, as necessary. 
Parameters can be ASCII or numeric. There can be up to four ASCII parameters 
and up to four numeric parameters. There must be at least one space between 
the NAME and any parameters. All parameters must be separated from each 
other by at least one space. Entry of an executive statement with too many 
parameters of either type, or without the required spaces between fields 
win result in a SYNTAX ERROR. 

ASCII parameters consist of from to 10 ASCII characters in the code range 
20H to 7EH except for 22H which is the double quote and 5FH and 7FH which 
are interpreted as backspace requests by the logical console input routines. 
ASCII parameters must be enclosed in double quotation marks. Entry of an 
executive statement with unbalanced quotation marks or illegal characters 
in an ASCII parameter will result in a SYNTAX ERROR. 

ASCII parameters in executive statements are generally used to specify 
disk filenames. In this usage a unit number may be prefixed to the ASCII 
filename within the quotation marks by typing the unit number followed by 
a colon (:) followed by the filename- This Indicates the disk drive unit 
on which the file is to be found. If no unit is specified, unit is 
assumed. The digit of the unit specification and the colon are not Included 
in the 10 character length restriction for ASCII parameters. For example, 
"DATAFILEOl" and "ItDATAFILEOl" are both valid ASCII parameters in an 
executive statement-. 

Numeric parameters in executive statements are unsigned hexadecimal values 
from to FFFF. They represent such elements as memory addresses, filetypes, 
and databytes. Entry of a numeric parameter with a value greater than FFFF 
or with Illegal characters will result in a SYNTAX ERROR. 

4.1.3 CANCELLING AN OPERATION 

All MDOS explicit commands and all application programs supplied by Micropolis 
can be cancelled in progress by holding down the control key and typing a 
C (CNTL/C) on the console keyboard. The operation will be terminated as soon 
as the CNTL/C is recognized and the message CANCELLED will be output to the 
console. Control is returned to the MOOS executive. 
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4.1.4 DISPLAY CONTROL 

All MDOS explicit commands and all application programs supplied by Micropolis 
can be temporarily stopped In progress by holding down the control key and 
typing an S (CNTL/S). The process will pause upon recognition of the CNTL/S. 
Typing any key other than CNTL/S or CNTL/C will cause the process to resume. 
This function is yery useful in controlling commands and programs that output 
displays at high speed. For example, the output of a DISP cormiand may be 
viewed at reading speed by stopping and resuming the output as necessary. 

4.1.5 EXPLICIT EXECUTIVE COMMANDS 

Cownand syntax for each of the MDOS explicit commands is illustrated in 
this section with the aid of the following notation: 

C ] Option brackets. Any parameters enclosed between brackets are 
optional. 

< > Symbol brackets. This space should be replaced by the item 
described. 

4.1.5.1 THE COMP COMMAND 

COMP <start addr. blockl> <end addr. blockl> <start addr. block2> 

The COMP command compares two blocks of memory and displays address locations 
that do not compare and the data at those locations. Example: 

>COMP 5000 5!3(3F 5010 
5004 01 09 5014 

The block of memory from 5000 to 500F is compared vrith the block of memory 
from 5010 to 501F. One location fails to compare. Location 5004 contains 
01 while the corresponding location, 5014, in the second block contains 09. 

4.1 .5.2 THE DUMP COMMAND 

DUMP <start addr.>C<end addr.>] 

The DUMP command outputs to the system console a formatted hex display of 
the contents of a block of memory. Sequential memory locations are shown 
16 to a line with the memory address at the left margin. If the optional end 
address parameter is not entered, only one byte is displayed. Example: 

>DUMP 5000 5011 

5000 50 C0 27 77 4F 33 4F CD 7D 9E 98 00 6A FD 82 90 

5010 77 28 

4.1.5.3 THE ENTR COMMAND 
ENTR <5tart addr.> 
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The ENTR command allows data to be entered into memory directly from the 
console device. Example: 

>ENTR 700f 
>78 89 
5F/ 

Three bytes were entered starting at location 7000 hex. These were 78 
at 7000, 89 at 7001, and 6F at location 70(82. 

Typing in an ENTR command places the executive in a special enter mode. 
While in the enter mode each line of values that is typed is entered into 
memory when the RETURN key is pressed. Until the RETURN key is pressed 
the standard backspacing and CNTL/X tools are available for line correction. 
The last value on the last line must be followed by a slash (/) to properly 
terminate the enter mode. Entry of a illegal hex value in any line will 
also cause termination of the enter mode with the message SYNTAX ERROR. 

4.1.5.4 THE FILL COMMAND 

FILL <start addr.> <end addr.> <byte> 

The FILL corranand fills a block of memory with a specified byte. 
Example: 

>FILL 7000 8000 9 

Each byte of memory in the block from 7000 to 8000 is changed to a 09 
by this command. 

4.1.5.5 THE MOVE COMMAND 

MOVE <source addr. start> <source addr. end> <dest. addr. start> 

The MOVE command copies the source block of memory to the destination 
block. The source block is not changed. The destination block is 
changed to be an exact copy of the source block. Example: 

>MOVE 3000 4000 7000 

Each byte In the memory block from 3000 to 4000 is copied into the 
corresponding position in the memory block from 7000 to 8000. 

4.1.5.6 THE SEAR COMMAND 

SEAR <start addr.> <end addr.> <byte> 

The SEAR command searches a block of memory for all occurrences of the 
specified byte and displays all locations with a match. Example: 

>SEAR 3000 3020 9F 
3004 9F 
3018 9F 

The block of memory from 3000 to 3020 is searched for all occurrences of 
a 9F. Location 3004 and location 3018 both contain 9F. No other 
locations in the block contain 9F. 
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4.1.5.7 THE SEARN COMMAND 

SEARN <start addr.> <end adclr.> <byte> 

The SEARN cominand searches a block of memory for all non-occurrences of a 
specified byte and displays all locations that do not match. Example: 

>SEARN 3000 3010 67 
3002 09 67 
3006 76 67 

The block of mencry from 3000 to 3010 1s searched for all non-matches with 
the mask 67. Location 3002 contained a 9 rather than a 67, and 3006 
contained a 76 rather than a 57. 

4.1.5.8 THE CREATE COMMAND 

CREATE "Cunit:]<filename>" [<file type>] 

The CREATE command creates a new file in the directory of the diskette 
in the specified unit and allocates the initial track for the file. If 
no unit is specified, unit is assumed. The second parameter optionally 
gives the file a TYPE designation. If no type is specified the type is 
defaulted to 0. 

4.1.5.9 THE DISP COMMAND 

DISP "[unit:]<filename>" [<record number>] 

The DISP command outputs a formatted hex display of the data contents of 
a file to the system console. The unit number indicates the disk drive 
on which the file is to be found. If no unit is specified, unit is 
assumed. The optional record number indicates on which record in the file 
the display is to begin. If no record number Is specified, record 1 1s 
assumed. 

Each record 1s displayed with a header line that contains the record 
number, the address 1n memory where the record is to be loaded, and the 
number of data bytes in the record. Data lines follow the record header. 
Each data line has up to sixteen data bytes preceded by the Index position 
in the record of the first data byte on that line. 

>DISP "1:TEST" 29 

0029 3C00 0022 

00 12 2A BO 76 SF ED 54 41 89 00 00 82 BC CC 76 89 

10 78 88 3B BB 88 54 58 56 90 88 32 31 30 00 00 00 

20 89 55 

00 2A 3C80 0003 

00 FF FF FF 

002B 3F00 0009 

00 45 43 48 4C 31 37 38 00 00 

002C 2B00 0000 

END-FILE 
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The first line of the display shows the record number 29, the load 
address 3C00, and the length of the record 22 bytes (all In hex). The 
header line Is followed by three lines which display the data In record 
29. Each data line starts with the index position of the first byte In the 
line. It is followed by two spaces and then the data. 

The next header 1s for record 2A which has a load address of 3C80 and 
contains 03 bytes of data. 

Record 2B has a load address 3F00 and contains 09 bytes of data. 

The last header Is for record 2C which has a load address of 2B00 and a 
record length of 0. If the file is an executable object file (like ASSM 
for example), the address In the zero length sector Is the execution 
address of the file. LOADing stops when the zero length sector is read. 
If the file is a run type which is being implicitly loaded and run, 
program control is transferred to the execution address. 
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4.1.5.10 THE FILES COMMAND 

FILES [<unit>] 

The FILES command outputs a formatted display of the file Inforrotlon 
in a diskette directory to the system console. The unit number 
indicates which disk drive directory is to be displayed. If no unit is 
specified, unit is assumed. Example: 



>FILES 1 






DIR 


03 


0000 


RES 


03 


0013 


MDOS 


0F 


001 C 


LINEEDIT 


15 


000C 


ASSM 


15 


0010 


SYMSAVE 


15 


0003 


FILECOPY 


15 


0003 


DISKCOPY 


• 0F 


0009 


BASIC 


0F 


004B 



The files on drive one are displayed on the console. The left column 
contains the filename, the second column is the file type, and the 
third column contains the number of sectors the file uses. All numbers 
are in hex. 

4.1.5.11 THE FREE COMMAND 

FREE [<un1t>] 

The FREE conmand outputs to the system console the number of tracks 
left unallocated (free) on a diskette. The unit ntmiber indicates which 
disk drive. If no unit is specified, unit is assumed. Example: 

>FREE 1 
0038 

The diskette on drive one has 38 tracks available to be allocated. 

4.1.5.12 THE SCRATCH COMMAND 

SCRATCH "Cunit:]<filename>" 

The SCRATCH command removes a named file from the directory of a diskette 
and returns its allocated tracks to available status. Disk drive is 
assumed if no unit is specified. 

Note: Some files cannot be SCRATCHed without first changing the file 
TYPE (see 4.1.5.9 and 4.2.3). 
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4.1.5.13 THE LOAD COMMAND 



The LOAD command loads (reads) a named file' from a diskette into the computers 
raemory and then returns control to the MOOS executive. If no unit number 
is specified, the file is expected to be found on unit 0. 

The LOAD command can be used in conjunction with two categories of files, 
OBJECT files and DATA files. The specific nature of the load that is 
performed depends on the category of the specified file to be loaded. The 
process of LOADing an OBJECT file is described in 4.1.5.13.1 . The process 
of LOADing a DATA file is described in 4.1.5.13.2. 

The LOAD cormiand can NOT be used to load a file in the OVERLAY category. 
An OVERLAY file is defined as any file with a file type value in the range 
0C - 0F hex (see Section 4.2.3). An attempt to LOAD an OVERLAY file results 
in the message yROMG FILE TYPE. OVERLAY files are not LOADable because 
they generally imply the replacement of the HDOS irodule and require irmnediate 
execution. Control cannot be returned to the MDOS executive and must be 
transferred immediately to the newly overlayed program module. If there is 
a necessity to LOAD an OVERLAY file into a memory area which does not 
conflict with MDOS, this can be done by changing the file type to an OBJECT 
type and then using an offset load per Section 4.1.5.13.1. 

4.1.5.13.1 THE LOAD COMMAND FOR OBJECT FILES 

An OBJECT file is defined as any file with a file type value in the range 
08 - 0B hex or 14 - IB hex. These ranges include ASSM object files, BASIC 
'save memory' files, executable system files, and executable user files 
(see Section 4.2.3). 

The format of the LOAD conmand for OBJECT files is: 

LOAD "[unit:] <filename>" [<start addr.>3 

OBJECT files are LOADed by using the address and length information in the 
header of each record of the file (see Section 4.2.4). This is called a 
'scatter load' because it permits records in the file to be loaded into 
non-contiguous portions of memory depending on the associated addresses. 
The LOAD is terminated when the first length record in the file is 
encountered. 

If the optional start address is not specified in the LOAD comnand, then 
the load of an OBJECT file proceeds according to the following example. 

The OBJECT file to be loaded is "TEST". 

DISP "TEST" 

0000 2B00 0005 

m 31 32 33 34 35 

0001 2C00 0004 
00 54 45 53 54 

0002 2B00 0000 
END- FILE 
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Typing LOAD "TEST" loads two text strings into memory. The string "12345" 
in record is loaded starting at 2B00 hex for five bytes. The test string 
"TEST" in record 1 is loaded starting at 2C00 hex for four bytes. The last 
record contains a zero length lector which terminates the load of an OBJECT 
type file. For an executable file the zero length sector contains the run 
address which in this case is 2B00 hex. This file, however, could not be 
a run file as it stands as there is no executable code. 

If the load address of the first record is less than 2B00 hex, the message 
LOAD ADDRESS ERROR is displayed because file may not be loaded beneath the 
MOOS application area. 

If the optional start-address is specified in the LOAD command, then the 
first record of the file is loaded starting at the specified address. The 
load address in the record header of the first record is subtracted from 
the start-address to produce an offset. When the records following the 
first record of the file are loaded, the calculated offset is added to the 
load address in the record header and the record is loaded starting at the 
calculated address. This is called an 'offset scatter load'. 

Using the file TEST in the example above, typing LOAD "TEST" 5000 loads the 
string "12345" starting at memory location 5000 hex for five bytes. The 
offset is calculated by subtracting the load address in the header of the first 
record from the start-address. 5000-2600=2500 hex. The string "TEST" is 
loaded starting at 5100 hex for four bytes. The load address in the header 
of the second record, 2C00 has the offset 2500 hex added to it and the result 
is the offset-load address. 

If the optional start-address is less than 2B00 the message LOAD ADDRESS 
ERROR is displayed. 

4.1.5.13.2 THE LOAD COMMAND FOR DATA FILES 

Any file which is not an OBJECT file and not an OVERLAY file is treated as 
a DATA file by the LOAD conmand. DATA files thereby include file type values 
in the ranges 0-7, 10-13 hex, and IC-FF hex. These ranges cover MDOS and 
BASIC DATA files, ASSM and LINEEDIT source files, BASIC program files and all 
of the unassigned file types (see Section 4.2.3). 

The format of the LOAD comnand for DATA files is: 

LOAD "[unit:] <filename>" <start addr.> 

The start address parameter is mandatory. If a start address is not specified 

a SYNTAX ERROR message will be displayed. If the start address is less than 

2B00 HEX a LOAD ADDRESS ERROR will result- This prevents accidental destruc- 
tion of the operating system. 
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Data is loaded starting at the specified address and continuing until the 
number of records in the file as shown in the directory have been loaded. 
The data is loaded into memory sequentially and contiguously. Only the 
number of data bytes in each record are loaded. The LOAD command does not 
pad records of less than 256 bytes. If a file were loaded at location 
3000 and the first record had only 4 data bytes in it, then the first data 
byte from the next record would be loaded at location 3W4. Records with 
zero length are skipped over. The load address in the sector header (see 
Section 4.2.4) has no meaning when doing a data LOAD. 



4.1.4.14 THE SAVE COMMAND 

SAVE "[unit:]<filename>" <start addr.> <end addr.> [<file type>] 
C<exec. addr.>] 

The SAVE conmand saves (writes) a new file to a diskette from a block 
of memory. The file is written sequentially from the memory start 
address through the memory end address into full sequential records. If 
no unit number is specified, the file is written to unit 0. If a file 
type is not specified the file type will be zero. If an execution address 
is not specified, the execution address of the file will be set to the 
start address of the memory block. Note that the type and execution 
address parameters are position dependent such that if an execution address 
is specified then a file type must also be present. Example: 

>SAVE "1:NEWFILE" 2B00 3700 3000 

A file is created on the diskette in drive one with the name NEWFILE 
and the memory block from 2B00 to 3700 is written to that file. The file 
is given a type of and the execution address saved with the file is 
3000. If no execution address had been specified then 2B00 would be 
saved as the execution address. 

4.1.5.15 THE RENAME COHHAND 

RENAME "[unit:]<filename>" "<new name>" 

The RENAME command changes the name of a diskette file to a specified 
new name. If no unit number is specified, the file to be renamed is 
expected to be found on unit 0. Example: 

>REMAME •'1:0LDFILE" "NEWFILE" 

The file named OLDFILE on the diskette in drive one is changed to NEWFILE 
on the diskette in drive one. The file type is unchanged by the renaming 
process. 
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4.1.5.16 THE TYPE COMMAND 

TYPE "[unit:]<filename>" <type> 

The TYPE command changes the type designation of a specified file. The 
type designation is a single hex byte. A definition of file types is 
given in Section 4.2. Example: 

>TYPE "IrPROGRAMX" 15 

The type of the file PROGRAMX one disk drive one is changed to a value 
of 15. 

4.1.5.17 THE APP COMMAND 

APP ["<ASCII>" '■<ASCII>"..."<ASCII>"] [<hex> <hex>. . .<hex>] 

The APP command transfers program control from the MOOS executive to 
the start of the MDOS applications area at 2B00 hex. It expects a valid 
executable program to be in the applications area with its entry point 
at the beginning. Up to four ASCII parameters and four hex parameters 
can be passed to the program. For example, if you are doing several 
assemblies, the assembler need only be read into memory once from diskette 
as it does not change itself in the process of assembling a program. 
After it is once in memory the APP command can be used to communicate with 
the assembler. Example: 

>APP "1: SOURCE" "OBJECT" "P" 

If the assembler were already in memory, the above example would transfer 
control and the necessary parameters to the program and the assembler 
would assemble the source file called SOURCE from drive one; produce an 
object file on drive zero called OBJECT; and output a paginated listing , 
on the print device. 

The APP coirmand functions like the EXEC command in that it PUSHes the 
address of the operating systems warm start entry point onto the system 
stack. Therefore if the program in the applications area does not provide 
its own stack, a RET would return control to the operating system. 

4.1.5.18 THE ASSIGN COMMAND 

ASSIGN <device #> <logica1 stream mask> [<width> <nun count>] 

The ASSIGiN command is a dual purpose command which provides the ability 
to specify the connections of physical output print devices to logical 
output streams and the values for carriage width and null count of the 
referenced physical device. The physical device number must be 1 or 2. 
The logical stream mask must be a 0,1,2, or 3. The device width and 
nullcount must be numeric values in the range 1 to FF hex. The width 
and nullcount parameters are optional. If width or nullcount are not 
included, the values corresponding to the referenced physical device 
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are not changed. If only the device width is included, then the 
nullcount is left unchanged. However, if a nuUcount is specified then 
the width must be present as a place holder even if it is the same. If 
the ASSIGN command contains only three parameters the third is always 
the width. 

Logical output stream number one consists of all output generated by 
system messages, keyboard echoing and the output from any explicit 
executive command. Logical output stream number two consists of all 
output generated by LISTP and PRINTP commands in the line editor, and 
by all listings in the assembler. The logical stream mask can be set to 
a three to represent both logical output streams one and two, or to a 
zero indicating that the device is to receive no output. 

Physical device number one represents the display element of the 
keyboard display device that is configured as the system console (see 
Section 2.2.4.1 on terminal configuration). Physical device number two 
represents the hard copy print device which is configured as the system 
printer (see Section 2.2.4.3). 

The output of a logical stream is directed to all physical devices 
which are assigned to it. A physical device may be assigned to one, 
both, or no logical streams. The ASSIGN command cancels any previous 
assignment of the specified device. 

In its initialized state the terminal is assigned to stream one only, 
and the printer is assigned to stream two only. This state can be 
restored by executing: 

>ASSIGN 11 
.>ASSIGN 2 2 

When the console and printer devices are configured, each device has a 
carriage width and nullcount parameter associated with it. These values 
may be changed by specifying optional third and fourth parameters in an 
appropriate ASSIGN command. The width parameter determines the maximum' 
number of characters on each line for the given device. When a line is 
output that is longer than this value an autowrap feature is activated 
and a carriage return and line feed is inserted at the appropriate point 
so that the logical line is continued on the next device line. The 
width can be changed on a given device by repeating the current assignment 
with the new width parameter. For example, if the console were currently 
assigned to stream one with a width of 80 characters (decimal), it could 
be changed to a width of 72 characters (decimal) as follows: 

>ASSIGN 1 1 48 

72 decimal is 48 hex. This width assignment will stay in effect until 
the width is specifically reassigned, or until the system is rebooted. 

The nullcount may have to be changed to accommodate unbuffered character 
serial devices which may lose characters while the carriage is being 
returned. The nullcount value is one greater than the actual number of 
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output nulls (ie. 1 will output no nulls). For example, if the printer 
were currently assigned to stream two at 132 characters per line and 
no nulls (nuncount=l ), the nuraber of output nulls could be changed to 
five with the following command: 

>ASSIGN 2 2 84 6 

132 decimal is 84, and 6 will result in five nulls being output after a 
carriage return. 

Because the MDOS executive language has been designed to be interactive 
it depends on the availability of a display device for system messages, 
keyboard echoing, and display of command results. Therefore an interlock 
is built into the system to ensure that stream one always has at least 
one device assigned to it. If an ASSIGN command violates this condition, 
then physical device one is automatically assigned to stream one as part 
of the assignment being processed. Additionally if the print device 
supports a printer attention condition (out of paper, motor off, etc.) 
the system will force the assignment to an initial state (ASSIGN 1 1, 
ASSIGN 2 2) if the printer signals that it needs attention. This ensures 
that the attention message will be output to the console. 

4.1.5.19 THE EXEC COMMAND 

EXEC <address> 

The EXEC command transfers processor control directly to the specified 
memory address. It expects a valid program to begin at that address. 
The address of the operating systems warm start entry point is PUSHed 
onto the 8080 's hardware stack by the EXEC command. Therefore, if the 
executed program does not set its own stack, a final RET in the program 
will return to the operating system. This feature allows subroutines to 
be exercised separate of the rest of a system under development. 

4.1.5.20 THE MATH COMMAND 

MATH <hex number> <hex number> 

The MATH command performs 16 bit integer math functions on the two specified 
hex numbers. It displays the sum, difference, product, quotient, and modulus, 

Example: 

>MATH 4 5 

0009 FFFF 0014 0000 0004 

The results are displayed from left to right: 4+5=9 ; 4-5=FFFF ; 4*5=14 
; 4/5=0 (intiger division) and a remainder (nwdulus) of 4. 

4.1.5.21 PROMPT "<ASCII>" 



The PROMPT command sets the executive prompt string to the value of the 
ASCII string. The string can be up to ten characters long. Spaces are 
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not allowed. The prompt is initially > when the system is configured. 
Example: 

>PROMPT "**" 



The prompt is changed from > to a ** 

4.1.5.22 THE INIT COMMAND 

INIT <unit> 

The INIT command initializes a diskette in the specified drive. The 
drive unit number must be specified. The INIT command formats the 
diskette by writing an empty block with the correct track and sector 
identification on every sector of the diskette and reading each sector 
to verify the media. It creates a blank directory and places a system 
loader on the diskette. The INIT corrmand essentially cleans the diskette 
of any data previously on the diskette and prepares it for new use. 
Accidental use of the INIT command could destroy the entire content of 
a diskette. Therefore, the system provides an interlock on this command. 
After the command is entered, the system prompts ARE YOU SURE?. It waits 
for a 'Y' or 'N' response to indicate yes or no. An 'N' cancels the 
corranand without doing any damage. Example: 

INIT 1 

ARE YOU SURE? 

The diskette on drive one will be initialized if a 'Y' is typed. All 
other replys will result in the command being canceled. Control returns 
to the executive. 
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4.2 MDOS DISK FILE I/O 

MDOS implements a powerful and efficient method for storage and retrieval 
of files on diskettes compatible with Micropolis disk subsystems. Track 
of each diskette contains a directory of the files on that diskette. 
Each directory entry holds the name, protection attributes, type, length 
and starting location for one file. Track also contains a track map 
Index that lists all unasslgned tracks and all tracks assigned to each file 
in the order of assignment. Files are stored on the remaining tracks of 
the diskette using a track indexed architecture that allows files to grow 
or shrink dynamically- Files ray be accessed sequentially by byte or 
record and directly (randomly) by record or byte within record. 

4.2.1 TRACK INDEXED FILE STORAGE 

The track indexed file storage scheme defines one track as the minimum 
disk space consumed by a file. The maximum storage assignable to one 
file 1s all tracks on the diskette (35 on WO I subsystems and 77 on 
MOD II subsystans), except the directory track 0. When MDOS creates a 
new file it assigns one track to that file. Additional file space is 
assigned to the file one track at a time as needed. Files are contiguous 
within a track but not necessarily from track to track. If a file is 
shortened, unused tracks are returned to available status. When a file 
is deleted (scratched), all of its assigned tracks are freed for 
reassignment. 

Maintenance of the track map in the track Indexed scheme operates as 
follows. Whenever a file is opened for access MOOS reads the track map 
from that files diskette into main memory. Any record in the file may 
then be accessed with only one disk seek by appropriate reference through 
the track map. File access operations that cause the file to be extended 
or shortened by one track also cause the track map to be irrmedlately 
updated 1n memory and on disk. When the file is closed Its directory 
entry Is rewritten to reflect any changes in the files size or status. 

4.2.2 FILE NAMES 

File names consist of from to 10 ASCII characters in the code range 

20H to 7EH except for 22H which is the double quote and 5FH and 7FH 

which are interpreted as backspace requests by the logical console 
input routines. 

A unit number may be prefixed to the" filename by typing the unit number 
followed by a colon (:) followed by the filename. This indicates the 
disk drive unit on which the file is to be found. If no unit is specified, 
unit is assumed. The digit of the unit specification and the colon 
are not included in the 10 character length restriction for ASCII para- 
meters. For example, DATAFILE01 and 1 :DATAFILE01 are both valid file 
names. 

If the file name is to be an implicit corranand in an executive statement 
there are additional restrictions that apply. The file name may not 
start with a blank. It may have no imbeded blanks and it may not exist 
in the MDOS explicit conmand table. 
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Files that are to be shared with BASIC must have valid BASIC file names. 
BASIC file names can be up to 10 characters long and use the ASCII 
characters from 2D hex through 5A hex except the colon {3A hex). This 
should be kept in mind when creating file names for MDOS. The BASIC 
file names are a subset of the MDOS file names and some incompatibility 
can occur if care is not used. 

4.2.3 FILE PROTECTION AHD TYPE DEFINITION 

MDOS provides two forms of file protection, A file can be write protected 
or a file can be delete protected. MDOS also allows files to be classified 
as to unique information content by assigning a type designation. A files' 
access codes and type designation are combined in one byte of the files' 
directory entry. The first two least significant bits of the file type 
byte are bit encoded and specify file access restrictions. The access 
codes are as follows: 

BIT 
1 

A normal read/write file 

1 A normal read only file 

1 A permanent read/write file 
1 1 A permanent read only file 

A normal file can be read, written, and deleted from the diskette by 
using the SCRATCH command (Section 4.1.2.5). A read only file can be 
read or SCRATCHed but it cannot be written into. A permanent file can 
be read or written but it cannot be SCRATCHed. A permanent read only 
file can be read but it cannot be written into or SCRATCHed. Attempts 
to SCRATCH a permanent file will result in the message PERM FILE. 
Attanpts to write into a read only file will result in the message READ 
ONLY FILE. The TYPE command may be used to change the access codes of a 
file if necessary. 

Note that these access code safeguards are software features that will 
only protect a file as long as the operating system has not been damaged. 
Diskettes may be physically write protected by placing a write protect 
tab over the slot in the upper right hand edge of the diskette. This 
causes the write electronics in Micropolls disk subsystems to be disabled 
when that diskette is loaded in a disk drive. 

The most significant six bits of the file type byte specify the type of file. 
This allows 64 different classifications of files each having four access 
codes. 

The codes through 7F hex are reserved for present and future system usage 
and should not be assigned other meanings by the user. The codes from 80 
to FF hex are available to the user and are not used by the system. 
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The executive, the assembler, and the editor check file types when called 
upon to load, save, or resave a file. If the file type is not correct 
the function will not take place. A table of file types follows: 

TYPE CODE DESCRIPTION 

1N_HEX_ _ 

00-03 MOOS & BASIC DATA FILES 

04-07 EDITOR/ASSEMBLER SOURCE FILES 

08-0B ASSEMBLER OBJECT & BASIC 'SAVE MEMORY' FILES 

0C-0F EXECUTABLE OVERLAY FILES 

10-13 BASIC PROGRAM FILES 

14-17 EXECUTABLE SYSTEM FILES 

18-18 EXECUTABLE USER FILES 

1C-7F RESERVED FOR FUTURE EXPANSION 

80-FF AVAILABLE FOR USER DEFINITION 

The line editor produces type 4 files. It can load type 4,5,6, and 7 files. 
The assembler will only assemble type 4,5,6, and 7 files. It produces 
type 8 files. 

Executable system files and user files may be loaded with the load command. 
Any attempt to load a file below the application program area will result 
in a LOAD ADDRESS ERROR. Executable overlay files may be loaded below the 
application program area by typing the file name as an implicit executive 
command. Any attempt to implicitly load a file that is not an overlay file 
will result in the message WRONS FILE TYPE. 

It is not possible to load an overlay file without beginning its execution. 
However, the entry point of the overlay could contain a jump to the MOOS 
warmstart address. This would return control to MOOS iinnediately after 
the overlay file was loaded, provided that the file did not overlay any 
functional MtWS code. 

4.2.4 FILE AND RECORD STRUCTURE 

An MOOS file consists of a group of related records stored on a diskette. 
The group is given a filename and type designation as described above. 
These are stored in the file directory on track of the diskette. 

Each record of an MOOS file begins with a two byte memory address followed 
by a two byte length indicator. The remainder of the record consists of 
to 256 data bytes. The memory address tells MOOS where in memory to load 
the data from that record. The length indicator tells MOOS how many valid 
data bytes are in the record. A record needs a minimum block of 4 bytes 
and a maximum block of 260 bytes to be properly stored. 

The records of a MOOS file are stored on the sectors of a diskette, one 
for one. Micropolis disk subsystems write a physical sector that is 258 
bytes long. The first 8 bytes of the sector are used for control purposes 
strictly by the operating system. The remaining 250 bytes are available 
for a record. Short records, including length (empty) records are 
possible. If a particular record has less than 256 data bytes the remainder 
of the sector is not used. However, the record may be expanded at any 
time by rewriting the sector to make use of the unused bytes.. 
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ADDR 


Bl B2 83 


E LINE# 


LABEL 


OPC( 


0000 




1000 


START 


ORG 


4000 


21 00 70 


2000 




LXI 


4003 




3000 


DATA 


DS 


4013 


00 


4000 


BYTE 


DB 


4014 




5000 


DATAl 


DS 


4024 


01 


6000 


BYTE! 


DB 


4025 


C3 25 40 


7000 


BEGIN 


JMP 


4028 




8000 




END 



The object program file that corresponds to the following assembly 
language program serves to illustrate the MDOS file and record structure. 

OPERAND 

4000H 

H,7000H 

10H 



10H 

1 

s 

BEGIN 

The first record of the object file has 4000 hex in the memory address 
bytes in Intel low/high format. The record length bytes contain 0003, 
indicating that the record has only three bytes of data. The three data 
bytes are 21 00 70. This record is written on the disk as one sector. 
The second record of the object file has a memory address of 4013 and a 
length of 0001, one byte of data 00. This record is also stored on the 
disk as one sector. The third record has a memory address of 4024 and a 
length of 0004, four bytes of data 01 C3 25 40. This record is stored 
on the disk as one sector. A fourth record is written that has a memory 
address 4025 and a length of 0000. This empty record marks the end of 
the object file and its memory address holds the execution address 
specified in the END statement. 

The structure of this object file is standard for all MDOS executable 
or memory load files. The file is allocated one entire track on the disk. 
It contains eight data bytes spread across 3 sectors. The 4th and last 
sector contains no data. Its memory address field holds the file 
execution address. Given an executable file type, the records of this file 
could be loaded into memory at 4000, 4013 and 4024 by typing its name to 
the executive. Direct processor control would transfer to 4025 to begin 
program execution. This type of file is called a scatter loadable file ■ 
because it can be loaded non-contiguously into main memory. 

Note: The number of records in each MDOS file is included in the directory 
entry for that file. This determines the end of file for data files. 
Data files do not require a zero length record to mark their end because 
there Is no execution address for a data file. The special zero length 
record is used with files that load into a range of memory and may require 
an associated execution address. For these files the zero length record 
is included in the record count in the files' directory entry. 

4.2.5 FILE ACCESS METHODS 

MDOS contains shared subroutines that allow user application programs to 
access diskette files sequentially by byte or record and directly (randomly) 
by record and byte within record. 

A file may be written sequentially by writing a byte at a time and 
Incrementing the Index position. The system buffers the bytes written 
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until a full 256 byte record is constructed and then writes it to the 
next sector in the file. The file space is automatically extended as 
necessary. A file may also be written sequentially by repeatedly writing 
blocks of data up to 255 bytes in length as one record and then incrementing 
the record position to the next record. A file written in this manner 
may have records of varying length up to 256 bytes. 

A file may be read sequentially by reading a byte at a time and increnenting 
the index position until the end of file is reached, . If the file contains 
any short records the unused bytes at the end of the sectors of those records 
will be automatically skiped by this byte sequential access, A file may 
also be read sequentially a record at a time by starting at the first record, 
reading the record length and then reading that number of bytes as a block, 
incrementing the record position to the next record, and repeating the 
process until the end of file is reached. 

A specific record in a file may be accessed by setting the index position 
directly to the start of that record. The record may then be read or written 
either a byte at a time or as a block of bytes. A specific byte in a 
directly accessed record may be read or written by first setting the index 
position directly to that byte in the record. These techniques facilitate 
the spot updating of a file. 

4.2.6 COMPATIBILITY BETWEEN MDOS AND BASIC FILES 

BASIC file names are a subset of MDOS file names. Therefore all BASIC files 
can be handled by the MDOS file name parsing logic, but not all MDOS file 
name can be handled fay BASIC. Refer to the Section 4.2.2 on FILE NAMES for 
a complete discussion. 

BASIC data files contain records of from zero to 250 bytes of data. The 
file and record structure is the same as that used by MDOS as discussed 
in Section 4.2.4. The two bytes at the start of the record which hold ,the 
length of the record can never be greater than 250 if the file is to be 
used by a BASIC program as a data file. BASIC will output an error message 
to the console stream and stop the program if the record length is greater 
than 250. MOOS can create BASIC readable files as follows: 

1000 * GET DATA TO BE WRITTEN INTO A BASIC COMPATABLE FILE 

-.CLOSE FILE & EXIT 



2000 


MVI 


8,250 


3000 GET 


CALL 


GETOATE 


3500 


JC 


EXIT 


4000 


CALL 


?WTINXPOSI 


5000 


OCR 


B 


6000 


JN2 


SET 


7000 


CALL 


SINCRECPOS 


8000 


JMP 


GET 



This partial program illustrates a method for writing 250 byte records 1 
For these records to be meaningful 1 to BASIC, the data must be seven bit 
ASCII with the proper BASIC string delimiters (refer to the STRING statement 
in the chapter on BASIC). The subroutine GETDATE is the users data acquisi- 
tion routine which returns the carry flag set when the process is done. 
0WTINXPOSI and ilNCRECPOS are MDOS subroutines which are documented in Section 
4.3.3. The method shown corresponds to the process for writing a file 
sequentially by record as described in Section 4.2.5. 
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4.3 MOOS SHARED SUBROUTINES 

MOOS provides the applications devel oiwient prograiimer with many useful 
subroutines that can be accessed directly from an applications program. 
These subroutines provide for console and printer character I/O, buffered 
line I/O, text line parameter parsing, sequential and random file access, 
file management, physical diskette access, and 16 bit integer arithmetic 
There are also a number of processor oriented utility subroutines. 

When you write an assembly language program, these subroutines can be 
referenced by name; e.g. CALL §HLAODA. The PDS MASTER diskette contains 
two files named SYSQl and SYSQ2. These are editor compatible source 
files that contain the names of all of the MOOS shared subroutines 
equated to their entry addresses. Application programs that reference 
these routines by name should include the SYSQl and SYSQ2 files in their 
assembly by using the assembler LINK pseudo-op, described in detail In 
Section 4.5. 

The following sections specify what arguments each subroutines expects, 
what arguments each subroutine returns, and how It functions. 

4.3.1 CONSOLE AND PRINTER INPUT/OUTPUT SUBROUTINES 

Micropolis Program Development Software packages perfonn input and output 
through the following subroutines. These routines link the system with 
the device handlers described in Chapter 11 under configuring for 
supported devices. 

The device handler routines start with a vector table whose address Is 
9CI0TABLE for the console, and iLIOTABLE for the printer. The routines 
in this section enter the drivers by indirectly accessing these tables 
using @CONSOLEADDR, and @LISTAODR which are buffers that hold pointers 
to the actual location of OCIOTABLE and @LIOTABLE. By changing the two 
bytes at locations iPCONSOLEAODR or 9LISTADDR the user can have special 
purpose drivers in memory at the same time as the standard drivers, 

4.3.1.1 laCIN - CONSOLE INPUT 

The ?CIN routine waits for Input from the system console. It strips 
parity and changes ASCII codes 5F (backarrow) and 7F (rubout) into 08 
(backspace). It returns the input character (7 bit ASCII) in the B 
register, with the carry flag clear (NC). It preserves the HL, DE, 
and C registers. 

4.3.1.2 iCOUT - CONSOLE OUTPUT 

The &COUT routines waits until the console stream is ready and then outputs 
a character. It changes carriage returns into a carriage return followed 
by the number of nulls associated with the device attached to the console 
stream. It changes ASCII code 08 hex (backspace) Into a 5F (backarrow). 
If the wrap logic for the device assigned to the console stream is enabled 
a line feed and a carriage return nulls sequence will be output when the 
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number of characters on the line equals the width. Refer to the ASSIGN 
command in the MDOS executive. It expects the character (7 bit ASCII) 
in the B register. It returns the carry flag set (C) if a printer 
attention condition occurs, and sets the assignment to ASSIGN 1 1, and 
ASSIGN 2 2. Refer to the ASSIGN command in the MDOS executive. It 
preserves the HL, DE, and BC registers. 

4.3.1.3 @CBRK - CONSOLE CHECK BREAK 

The (3CBRK routine ^checks the console device for the input of a cancel 
(control C), or a 'pause (control S). It returns the zero flag set (Z) 
and the CANCELED message code in the A register if a CONTROL C (03) is 
input. It preserves the HL, DE, and C registers. On pause (control S) 
the routine loops, waiting for another character to be input. Entry of 
any character other than control S will terminate the pause and return 
to the caller. 

4.3.1.4 SCDIN - CONSOLE DEVICE INPUT 

The (aCDIN routine waits for input from the console device. It returns the 
character (8 bits including parity) in the B register, with the carry flag 
clear (NC). It preserves the DE, HL, and C registers. 

4.3.1.5 fCDOUT - CONSOLE DEVICE OUTPUT 

The SCDOUT routine waits until the console device is ready to receive a 
byte and then outputs it. It expects the byte for output in the 3 register. 
It preserves the DE, HL, and BC registers. It returns the carry flag clear 
(NC). 

4.3.1.6 gCDBRK - CONSOLE DEVICE BREAK CHECK 

The @CDBRK routine checks the console input ready status. If an input • 
is ready It gets the input. Otherwise it returns immediately. It returns 
the zero flag set (Z) and the input character (8 bits including parity) 
in the B register if there was an input. It preserves the DE, HL, and C 
registers. If there was no input the @CDBRK routine returns the zero flag 
clear (NZ), and the B register Is unchanged. 

4.3.1.7 @CDINIT - CONSOLE DEVICE INITIALIZATION 

The ICDINIT routine initializes the console Interface device. It preserves 
the HL, DE, and BC registers. It returns the carry flag clear (NC). 

4.3.1.8 OLOUT - LIST OUTPUT 

The §LOUT routine waits until the list stream is ready to receive and 
then outputs a character. It changes carriage returns into a carriage 
return followed by the number of nulls associated with the device attached 
to the list stream. It changes ASCII code 08 hex (backspace) into a 5F 
(backarrow). If the wrap logic for the device assigned to the list stream 
is enabled a line feed and a carriage return nulls sequence will be output 
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when the number of characters on the line equals the width. Refer to 
the ASSIGN conmand in the MDOS executive. It expects the character 
(7 bit ASCII) in the B register. It returns the carry flag set (C) if 
a printer attention condition occurs, and sets the assignment to ASSIGN 
1 1, and ASSIGN 2 2. Refer to the ASSIGN command in the MDOS executive. 
It preserves the HL, DE. and BC registers. 

4.3.1 -g giATN - LIST ATTENTION 

The f3LATN routine checks the list stream for a printer attention condition. 
It returns the carry flag set (C) if a printer attention condition occurs, 
and sets the assignment to ASSIGN 1 1 , and ASSIGN 2 2. Refer to the ASSIGN 
command in the MOOS executive. It preserves the HL, DE, and BC registers. 

4.3.1.10 gLDOUT - LIST DEVICE OUTPUT 

The @LDOUT routine waits until the list device is ready to receive a byte 
and then outputs it. It expects the byte for output in the B register. 
It preserves the DE, HL, and BC registers. It returns the carry flag 
set (C) if a printer attention occurs. 

4.3.1.11 9LDATN - LIST DEVICE ATTENTION 

The §LOATN routine checks the list device for a printer attention condition. 
It returns the carry flag set (C) if a printer attention condition occurs. 
It preserves the HL, DE, and BC registers. 

4.3.1.12 I3LDINIT - LIST DEVICE INITIALIZATION 

ThefLDINIT routine initializes the list device. It preserves the HL, DE, 
and BC registers. It returns the carry flag clear (NC). 

4.3.1.13 9CCRLF - CONSOLE LINE FEED CARRIAGE RETURH 

The ?CCRLF routine outputs a line feed carriage return and nulls to the 
console stream. It returns the carry flag set (C) If a printer attention 
condition occurs, and changes the assignment to ASSIGN 1 1, and ASSIGN 2 2. 
Refer to the ASSIGN command in the MDOS executive. It preserves the HL, 
DE, and BC registers. 

4.3.1.14 @LCRLF - LIST LINE FEED CARRIAGE RETURN 

The laLCRLF routine outputs a line feed carriage return and nulls to the 
list output stream. It returns the carry flag set (C) if a printer attention 
condition occurs, and changes the assignment to ASSIGN 1 1, and ASSIGN 2 2. 
Refer to the ASSIGN command in the MDOS executive. It preserves the HL, 
DE, and BC registers. 

4.3.1.15 @ASSIGN - ASSIGN 

The 9ASSI6N routine assigns the physical device to specified logical stream(s) 
and sets the width and nullcount associated with the device. It expects the 
physical device number in the E register, the logical stream mask in the D 
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register, the width 1n the C register, the nullcount (nulls+1) in the B 
register, and the number of parameters passed in the H register. No 
registers are preserved. (Refer to the ASSIGN command in the executive for 
a detailed discussion of physical device assignment to logical output 
streams). 

4.3.1.16 eCILINE - CONSOLE INPUT L INE 

The aciLINE routine outputs a specified prompt message to the console 
and then buffers up to 132 characters of input text from the console 
device. It provides the standard backspace (rubout) and line cancel 
(CNTL/X) controls during the line entry process. The text line input is 
terminated by a carriage return. (Note: The carriage return is not echoed 
to the console). It expects the address of a string of text to be output 
as a prompt in the HL registers. The message pointed to must be properly 
terminated with a byte code of i3 through IF hex or the high order eight 
bit of the last byte set. It returns the input line in 9INBUFF, and the 
number of input characters including the terminating carriage return in the 
B register. It preserves the HL, DE, and C registers. Any control char- 
acters input during the line entry process are echoed to the console str.eam 
but not entered into @INBUFF. 

4.3.1.17 gHEXOUT - HEXADECIWL OUTPUT 

The @HEXOUT routine converts an unsigned 8 bit binary value in the A 
register to a hex number and outputs the number to the console. It returns 
the carry flag set (C) if a printer attention condition occurs, and changes 
the assignment to ASSIGN 1 1, and ASSIOI 2 2. Refer to the ASSIGN conmand 
in the MDOS executive. It preserves the HL, DE, and C registers. 

4.3.1.18 §HEXADDOUT - HEXADECIHAL ADDRESS OUTPUT 

The §HEXADDOUT routine converts an unsigned 16 bit binary value in the 
HL registers to a hex number and outputs the number to the console followed 
by one space character. It returns the carry flag set (C) if a printer 
attention condition occurs, and changes the assignment to ASSIGN 1 1, and 
ASSIGN 2 2. Refer to the ASSIGN comnand in the MCX3S executive. It preserves 
the HL, DE, and C registers. 

4.3.1.19 @HEXOUTSPC - HEXADECIMAL OUTPUT WITH SPACE 

The (PHEXOUTSPC routine converts an unsigned 8 bit binary value in the 
HL registers to a hex number and outputs the number to the console 
followed by one space character. It returns the carry flag set (C) if 
a printer attention condition occurs, and changes the assignment to 
ASSIGN 1 1, and ASSIGN 2 2. Refer to the ASSIGN command in the MDOS 
executive. It preserves the HL, DE, and C registers - 

4.3.1.20 §SPACEQUT - SPACE OUTPUT 

The §SPACEOUT routine outputs a space (20 hex) to the console stream. 
It returns the carry flag set (C) if a printer attention condition occurs, 
and changes the assignment to ASSIGN 1 1 , and ASSIGN 2 2. Refer to the 
ASSIGN command in the MDOS executive. It preserves the HL, DE, and 
C registers. 
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4.3.1.21 @NLINEOUT - NEW LINE OUTPUT 

The I3NLINE0UT routine outputs a carriage return line feed and a line of 
text to the console stream. It expects the address of the beginning of the 
text line in the HL registers. The message pointed to must be properly 
terminated with a byte code in the range through IF hex or the high 
order eighth bit of the last byte set. It returns the carry flag 
clear (NC) 1n all cases. It preserves the HL, DE, and C registers. 



4.3.1.22 gLINEOUT - LINE OUTPUT 

The @LINEOUT routine outputs a line of text to the console stream. It 
expects the address of the beginning of the text line in the HL registers. 
The message pointed to must be properly terminated with a byte code in 
the range through IF hex or the high order eighth bit of the last byte 
set. It returns the carry flag clear (NC) in all cases. It preserves 
the HL, DE, and C registers. 



4.3.2 TEXT LINE PARSING SUBROUTINES 

The following routines are used by the system to parse input command lines 
for the MDOS executive. After the command has been entered into the input 
buffer using iCILINE, the fSCAN routine is used to locate the first space 
after the command, and dSKIPSPACE skips to the first non-space character. 
Then the fPARAM routine separates the conmand parameters into buffers according 
to their type. §PARAM makes use of @SCAN, ISKIPSPACE, and @AHEXTBIN to do 
its job. After the parameter types have been separated, the address of the 
beginning of the input buffer is placed into (PMASKADDR and the OSEAR routine 
searches the MDOS command table for a match. If the command is valid, the 
@SEAR routine returns with the zero flag clear and 9LHLI will get the function 
from the table, which In this case is an address. Control is passed to the 
command routine with a PCHL instruction. The command routine can retrieve 
the parameters from the appropriate buffers with LHLD instructions. 

The user can use these routines to parse applications program input lines 
using similar logic. 

4.3.2.1 gPARAN - PARAMETER 

The @PARAM routine parses a text line. It separates parameters into ASCII, 
numeric and unit numbers. It counts the number of occurrences of each 
parameter type and places the count and each parameter in a separate buffer. 

It expects the start address of the text to be parsed in the HL registers. 

It returns ASCII parameters in OASCBUFF0 through §ASCBUFF3. 

It returns unit numbers in (3DRIVEN0 through @DRIVEN3. 
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It returns binary (numeric) parameters In (aBBUFF0 through IBBUFFS. 

It returns the number of ASCII parameters in iNASCPAR. 

It returns the number of unit number parameters 1n ?NDRVPAR. 

It returns the number of binary parameters in iNBINPAR. 

It returns the carry flag clear (NC) and the end of line address in the 
HL registers if there were no errors. 

It preserves the OE and BC registers. 

If a parameter is in error the carry flag is set (C), the SYNTAX ERROR 
code is 1n the A register, and the location where the error occurred Is 
returned in the HL registers. 

4.3.2.2 gSKIPSPACE - SKIP SPACES 

The (PSKIPSPACE routine skips spaces in a text line. 

It expects the text line's start address In the HL register. 

It returns the address in the HL registers of the first non-space character. 

If the character Is a control character the carry flag is set (C). 

It preserves the DE and BC registers. 

4.3.2.3 gSCAN ■■ SCAN 

The 9SCMi routine scans a text line for the first occurrence of a specified 
character. 

It expects the text line's starting address in the HL registers and the 
mask character In the C register. 

It returns the address in the HL register where the match occurred and 
the number of characters passed over in the B register. 

The carry flag is set (C) If the mask character was not found prior to 
a control character. 

It preserves the DE and C registers. 

4.3.2.4 gSEAR - SEARCH 

The ©SEAR routine searches a table of argument-function pairs and returns 
the address of the function associated with the argument. The last character 
of the argument has the most significant bit set high. For example, an 
ASCII A is 41 hex. If the most significant bit is set high It is a CI hex. 
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The argument is inmediately followed by its function. The arguments can be 
variable length but the functions must all be the same length. The end of 
the table is marked by a following the last function. 
It expects the table's start address in the HL register and the argument 
masks' starting address in ^MASKADDR. The argument mask string must be 
terminated by a space or control character. It expects the A register to 
contain the size (number of bytes) of the functions in the table. 

It returns the zero flag clear (N2) and the address of the start of the 
argument's function in the HL register. 

The zero flag is set (Z) if the argument was not in the table. In this 
case the HL registers contain the end of table address, ie. the address of 
the after the last function. 
It preserves the DE and BC registers. 

4.3.2.5 9AHEXTBIN > ASCII HEX TO BINARY 

The ©AHEXTBIN routine converts a text string of unsigned hexadecimal digits 
represented in ASCII code into a binary number. The string can be one to 
four digits in length. It must end with a space or control character. 

It expects the string's start address in the OE registers. 

It returns a 16 bit binary number in the HL registers. 

It returns the number of digits in the number in the B register. 

It returns the DE registers pointing to the space or control character 
that ends the text string. 

It preserves the C register. 

If the number is greater than four digits long or not a hex value, the 
routine returns the carry flag clear (NC) and the illegal character's 
address in the DE registers. 

4.3.3 THE FILE ACCESS ROUTINES 

The file access subroutines implement the HDDS file access methods described 
in Section 4.2.5. They allow an open disk file to be accessed sequentially 
by byte or record and directly (randomly) by record and byte within record. 

Before a file can be accessed it must be opened. To open a named file on 
a specified disk unit the file must be assigned a logical file number 
and a filebuffer. MDOS supports simultaneously open files numbered from 
through 7. It makes available two resident filebuffers. Additional 
filebuffers must be allocated in the memory space of the application 
program. Each filebuffer requires 288 bytes of memory. 
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When a file is opened the first record of the file is read into its 
filebuffer. The record in the file buffer of a file at any given time 
is called the current record of that file. Associated with the current 
record of each open file is an update flag. Any access that nwdifies 
the content of the current record will cause the update flag to be set. 
If the update flag is set, any access that leads to the current record 
being replaced by a new record will first cause the current record with 
the modified content to be rewritten in place (updated) to the disk 
file. If the update flag is not set, no update takes place before a new 
record is read. Invoking a new record resets the update flag. 

The current record of each open file has a record length which is written 
with the record as described in Section 4.2.4. Its value may vary from 
to 255. A length record indicates an empty record that still occupies 
one physical sector on the diskette. A 256 byte record is a full record 
that cannot be extended. 

The index position of the current record is a logical pointer that marks 
the next byte in the record to be accessed. The value of the index position 
ranges from to 255. However, the index position may never be greater than 
the length in a particular record. An Index position of 3 indicates that 
the next byte to be accessed is the first byte in a record. An index 
position of 255 indicates that the next byte to be accessed 1s the last 
byte in a full record. 

If the index position in the current record is less than the current record 
length, then it points to a valid byte position within the record. That 
byte may be read or rewritten. If the index position 1s equal to the current 
record length, then it points to ttie end of record (EOR) position which is 
the first non valid byte position in a non full record. The EOR position 
nay be written but it may not be read. 

Reading from the end of record position updates the current record to disk 
as necessary and the next record in the file becomes the current record. 
The index position is set to and the data is read from this position. 
This allows files containing a mixture of non full records to be read 
sequentially by byte. 

If the end of record position is written to, the length of the current 
record is increased by one and the position Just written becomes a valid 
byte position. This allows data to be added to the end of a record extending 
it up to Its maximum length of 256 bytes. Note, however, that incrementing 
the index position when it already has a value of 255 updates the current 
record to disk as necessary and the next record of the file becomes the 
current record. The index position will be set to 0. 

A new file may be written sequentially by byte by repeatedly writing to 
the index position and incrementing the index position. This will produce 
a file of full records with the possible exception of the last record. The 
system automatically extends the amount of disk space allocated to a file 
when enough new records are written to require another track. 
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The current record of each open file also has a record position number 
associated with it. The record position number specifies which record 
the current record is in the file. The record position number may be 
set or incremented. Setting the record position updates the current 
record to disk as necessary and the specified record from the file is 
read and becomes the current record. This provides a mechanism for 
direct (random) access to any record in a file. Incrementing the record 
position number updates the current record to disk as necessary and the 
next record in the file is read and becomes the current record. This 
function can be used to sequentially write a file of short/mixed length 
records . 

When processing of a file 1s complete, the file must be closed. Closing 
a file updates the current record to disk as necessary and frees the 
logical file number and the filebuffer for subsequent reallocation. 

4.3.3.1 gCREATE - CREATE 

The @CREATE routine creates a file of a specified type on a specified 
disk unit. The created file has one track allocated to it and one empty 
(0 length) record written to it. It is left open and ready for access 
with the index position set to and the empty record as the current 
record. 

It expects the file number 1n the B register and the disk unit number in the 
C register and the filename in @ASCIIBUFF. 

It expects the file type in the D register and the start address of the 
file buffer in the HL registers. 

If the routine detects an error it returns the carry flag set (C) and 
the error message code in the A register. 

It preserves the HL,. DE, and EC registers. 

4.3.3.2 I3GFILESTAT - GET FILE STATUS 

The ©GFILESTAT routine checks the open/closed status of a file. 

It expects the file number in the B register. 

If the file is closed it returns with the zero flag set (Z) and the 
"FILE NOT OPEN" message code in the A register. 

It preserves the HL, DE, and BC registers. 

If the routine detects an error it returns the carry flag set (C) and 
the error message code in the A register. 
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4.3.3.3 gPIRSEARCH - DIRECTORY SEARCH 

The (?DIRSEARCH routine reads the directory of a specified disk unit to 
determine if a specified file exists. 

It expects the unit number in the C register and the file name in 
@ASCIIBUFF. 

It returns the zero flag clear (NZ) and the "FILE NOT FOUND" message 
code in the A register if the file is not in the directory. 

It preserves the HL, DE, and BC registers. 

If the routine detects an error it returns the carry flag set (C) and 
the error message code in the A register. 

4.3.3.4 gOPENFILE - OPEN A FILE 

The §OPENFILE routine opens a file for processing. It assigns a specified 
logical file number and filebuffer to the file. 

It expects the file name in @ASCIIBUFF, the file number in the B register, 
and the drive number in the C register. 

It expects the address of the file buffer in the HL registers. 

It preserves the HL, DE", and BC registers. 

If the routine detects an error it returns the carry flag set (C) and 
the error message code in the A register. 

4.3.3.5 gCLOSEFILE - CLOSE A FILE 

The iCLOSEFILE routine updates the current record to disk as necessary 
and frees the logical file number and the filebuffer for subsequent 
reallocation. 

It expects the file number in the B register. 

It preserves the HL, DE, and BC registers. 

If the routine detects an error it returns the carry flag set (C) and 
the error message code in the A register. 

4.3.3.6 gRFILEINF - READ FILE INFORMATION 

The @RFILEINF routine gets the disk unit number, the number of records 
in the file, the file type, and the record position number of the 
current record. 

It expects the file number in the B register. 
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It returns the file type in the B register and the disk unit number in 
the C register. 

It returns the number of records in the file in the DE registers. 

It returns the record position number of the current record in the HL 
registers. 

If the routine detects an error it returns the carry flag set (C) and 
the error message code in the A register. 

4.3.3.7 gSINXTRS - SET INDEX POSITION TO RECORD START 

The iSINXTRS routine updates the current record to disk as necessary 
and reads a specified record which becomes the current record. The 
index position is set to 0. 

It expects the file number in the B register and the record number in 
the HL registers. 

It preserves the HL, DE, BC registers. 

If the routine detects an error it returns the carry flag set (C) and 
the error message code in the A register. 

4.3.3.8 @RRECORDLEN - READ RECORD LENGTH 

The ©RRECORDLEN routine gets the length of the current record in a file. 

It expects the file number in the B register. 

It returns the length of the record in the HL registers. 

It preserves the DE and BC registers. 

If the routine detects an error it returns the carry flag set (C) and 
the error message code in the A register. 

4.3.3.9 @RINXPOS - READ INDEX POSITION 

The @RINXPOS routine gets the index position of the current record of a 
file. 

It expects the file number in the B register. 

It returns the index position in the C register. 

It preserves the HL, DE, B registers. 

If the routine detects an error it returns the carry flag set (C) and 
the error message code in the A register. 
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4.3.3.10 iSINXPOS - SET INDEX POSITION 

The iSINXPOS routine sets the index position within the current record 
in a file. 

It expects the file number in the B register and the index position 1n 
the C register. 

It preserves the HL, OE, BC registers. 

If the routine detects an error it returns the carry flag set (C) and 
the error message code in the A register, 

4.3.3.11 ilNCINX ~ INCREMENT INDEX POSITION 

The fINCINX routine increments the index position in the current record 
of a file. If the increment would result in a value greater than the 
current record length, then the current record is updated to disk as 
necessary and the next record of the file becomes the current record 
and the index position is set to 0. 

It expects the file number in the B register. 

It returns the zero flag set (Z) if the index position Is in the same 
record. 

It returns the zero flag clear (NZ) if the index position is In a new 
record. 

It preserves the HL, DE, BC registers. 

If the routine detects an error It returns the carry flag set (C) and 
the error nessage code in the A register. 

4.3.3.12 gRFINXPOS - READ FROM INDEX POSITION 

The SRFINXPOS routine reads the data byte pointed to by the index position 
in -the current record of a file. If the index position is at the EOR 
position the current record is updated to disk as necessary and the next 
record of the file becomes the current record. The index position is 
set to and the data is read from this position. 

It expects the file number in the 8 register. 

It returns the data in the C register. 

It returns the zero flag set (Z) if the data is from the same record. 

It returns the zero flag clear (NZ) If the data 1s from a new record. 

It preserves the HL, OE, B registers. 

If the routine detects an error it returns the carry flag set CCl and 
the error message code in the A register. 
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4.3.3.13 @RFINXPOSI - READ FROM INDEX POSITION AND INCREMENT INDEX 

The @RFINXPOSI reads the data byte pointed to by the index position in 
the current record of a file and then increments the index position. If 
the original index position is at the EOR position, the current record 
is updated to disk as necessary and the next record of the file becomes 
.the current record. The index position is set to and the data is read 
from that position. Then the increment takes place. If the increment 
■'would result in a value greater than the current record length, the 
current record is updated to disk as necessary and the next record from 
the file becomes the current record. The index position is set to 3 in 
that case. 

It expects the file number in B. 

It returns the data in the C register. 

It returns the zero flag set (Z) if the data is from the same record. 

It returns the zero flag clear (NZ) if the data is from a new record. 

It preserves the HL, DE, BC registers. 

If the routine detects an error it returns the carry flag set (C) and 
the error message code in the A register. 

4.3.3.14 gWTINXPOS --MRITE TO INDEX POSITION 

The ?WTINXPOS routine writes to the index position in the current record 
of a file. If the index position is the EOR position the record length is 
extended by one. 

It expects the data in the C register, and the filenumber in the B . 
register. 

It preserves the HL, DE, BC registers 

If the routine detects an error it returns the carry flag set (C) and 
the error message code in the A register. 

It returns the zero flag set (Z) if the data is from the 
same record. 

It returns the zero flag clear (NZ) if the data is from a 
new record. 

4.3.3.15 gyrriNXPOsi - write to index position and increment index 

The §WTINXP0SI routine writes to the index position in the current record 
and then increments the index position. If the index position is the 
EOR position the current record length is extended by one. If the incre- 
ment would result in an index greater than 255, then the current record 
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1s updated to disk as necessary and the next record in the file, becomes 
the current record. The index position is set to p in this case. 

It expects the data in the C register, and the filenumber in the B register. 

It preserves the HL, OE, BC registers. 

If the routine detects an error it returns the carry flag set (C) and 
the error message code in the A register. 

It returns the zero flag set (Z) if the data is from the same record. 

It returns the zero flag clear (NZ) if the data is from a new record. 

4.3.3.16 (aiOADOATA - LOAD DATA 

The @LOADDATA routine loads a block of data into memory starting from 
the index position in the current record and continuing from a specified 
number of bytes. It advances the index position like a repeated sequence of 
reads and increments. 

It expects the file number in the B register. 

It expects the start address of the manory block in the HL registers. 

It expects the block size, in the OE registers. 

It returns the zero flag set (Z) If the last byte read is from the 
same record as the first byte. 

It returns the zero flag clear (NZ) if the last byte read is from a new 
record . 

It preserves the HL, DE, BC registers. 

If the routine detects an error it returns the carry flag set (C) and 
the error message code in the A register. 

After a call to dLOADDATA the buffer laMEMORYPNTR contains the address 
of the memory byte immediately after the last memory byte loaded. 
For example. If 5 bytes are loaded into 4^00H through 4004H, then 
§MEMORYPNTR contains the address 48)gi5H in standard low-high format. This 
is useful in cases where the number of bytes loaded is less than the number 
of bytes requested because an end of file is encountered during the @LOADOATA. 

4.3.3.17 eSAVEOATA - SAVE DATA 

The SSAVEDATA routine writes a block of memory to a file starting at 
the index position of the current record and continuing for a specified 
number of bytes. It advances the index position like a repeated 
sequence of writes and increments. 

It expects the file number in the B register. 
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It expects the start address of the memory block in the HL registers. 

It expects the number of bytes in the memory block in the DE registers. 

It preserves the HL, DE, BC registers. 

If the routine detects an error it returns the carry flag set (C) and 
the error message code in the A register. 

It returns the zero flag set (Z) if the last byte read is from the same 
record as the first byte. 

It returns the zero flag clear (NZ) if the last byte read is from a new 
record. 

After a call to fSAVEDATA the buffer WEMORYPNTR contains the address of the 
memory byte immediately after the last memory byte saved. For example, if 5 
bytes are saved from 400^H to 42)04H then @MEMORYPNTR contains 4005H in 
standard low-high format. This is useful 1n cases where a DISK FULL 
condition causes less bytes to saved than are requested in the call to 
eSAVEDATA. 

4.3.3.18 §DFINXPOSTEOR - DELETE FROM INDEX POSITION TO END OF RECORD 

The 9DFINXP0STE0R routine deletes fran the index position to the end of 
the current record by making the record length equal to the value of 
the index position. 

It expects the file number in the B register. 

It preserves the HL, DE, BC registers. 

If the routine detects an error it returns the carry flag set (C) and 
the error message code in the A register. 
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4.3.3.19 gPFINXPOS - DELETE FROM INDEX POSITION TO END OF FILE 

The iDFINXPOS routine deletes from the index position to the end of the 
file by making the number of records in the file equal to the record 
position nurrtser of the current record and the current record length 
equal to the value of the index position. Any tracks no longer required 
by the file due to the deletion are freed for subsequent reallocation 
to other files. 

It expects the file number in the B register. 

It preserves the HL, DE, BC registers. 

If the routine detects an error it returns the carry flag set (C) and 
the error message code in the A register. 

4.3.3.20 &INCRECPOS - INCREMENT RECORD POSITION 

The @INCRECPOS routine updates the current record to disk as necessary, 
reads in the next record which becomes the current record and sets the 
index position to 0. If the current record is the last record in the 
file, the file is automatically extended by one record. 

It expects the file number in the B register. 

It preserves the HL, DE, BC registers. 

If the routine detects an error it returns the carry flag set (C) and 
the error message code in the A register. 

4.3.4 FILE MANAGEMENT SUBROUTINES 

In addition to accessing named files on the disk it becomes necessary 
on occasion to perform housekeeping functions such as removing old files, 
changing file types and names, and determining the amount of space left 
on a disk for additional files. These functions are available as executive 
coimnands, and are also provided as subroutines that may be used directly 
by applications programs. 

4.3.4.1 §FREE - FREE 

The iFREE routine returns the number of tracks left on a diskette that 
are free and available for allocation to a file. 

It expects the unit number in the C register. 

It returns the number of free tracks in the HL registers. 

If the routine detects an error it returns the carry flag set (C) and 
the error message code in the A register. 

4.3.4.2 gRENAME - RENAME 

The iRENAME routine renames a file on a diskette. 
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It expects the file number in the B register. 

It expects the new name in ©ASCIIBUFF. 

It preserves the HL, DE, and BC registers. 

If the routine detects an error it returns the carry flag set (C) and 
the error message code in the A register. 

4.3.4.3 giYPE - FILE TYPE 

The @TYPE routine changes the type (attributes) of a file. See Section 
4.2.3 for type definitions. 

It expects the file number in the B register. 

It expects the new file type in the C register. 

It preserves the HL, DE, and BC registers. 

If the routine detects an error it returns the carry flag set (C) and 
the error message code in the A register. 

4.3.4.4 ^SCRATCH - SCRATCH A FILE 

The @SCRATCH routine deletes a specified file from a specified disk unit- 
It expects the unit number in the C register. 
It expects the file name in @ASCIIBUFF. 
It preserves the HL, DE, and BC registers. 

If the routine detects an error it returns the carry flag set (C) and 
the error message code in the A register. 

4.3.5 PHYSICAL DISK ACCESS ROUTINES 

The physical disk access subroutines are the most primitive level of 
access provided within the HDOS context. They allow a diskette to be 
treated as a collection of logical blocks independent of the MMS file 
system and provide access to a specified logical block on a specified 
track of a diskette. 

Micropolis MOD I disk subsystems write 35 tracks on one side of a diskette. 
The MOO II subsystems write 77 tracks on one side of a diskette. A track 
in either subsystem is divided into 16 sectors each of which contains 268 
bytes. Tracks numbered through 34 or 76 are written concentrically 
inward toward the center of the diskette. The physical sectors on a track 
are numbered from through 15. 
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Diskettes initialized by and formatted for use with MDOS have the track 
number written in the first byte and the physical sector number written 
in the second byte of each sector of a track. These bytes are maintained 
exclusively by the operating system. 

The remaining 266 bytes of a sector are accessible as a logical block 
by the MDOS physical disk access routines. In order to enhance access 
time to multiple blocks, MOOS maps logically sequential blocks onto the 
physical sectors of a track in a staggered pattern as shown. 

LOGICAL BLOCKS 12 3 4 5 6 7 8 9 10 11 12 13 14 15 16 
PHYSICAL SECTORS 2 4 6 8 10 12 14 1 3 5 7 9 11 13 15 

The physical disk access routines automatically access the correct 
physical sector that corresponds to the logical block that is specified. 
If it is necessary to access the sectors of a track in true physically 
sequential order, the application program must use the table above to 
unmap the sectors. For example, to access sector followed by sector 1 . 
the program would have to specify logical block 1 followed by logical 
block 9. 

Note that the record structure of HOGS files as detailed 1n Section 
4.2.4 must be preserved if the physical disk access routines are used 
to operate on such records. 

4.3.5.1 JGETASEC - GET A SECTOR 

The 9GETASEC routine gets (reads) a sector from a specified disk unit 
into a specified memory buffer given the track and logical block numbers. 

It expects the unit number in the C register. 

It expects the track number in the D register and the logical block number 
in the E register. 

It expects the address in the HL register of the start of a 266 byte buffer. 

If the routine detects an error it returns the carry flag set (C) and 
the error message code in the A register. 

4.3.5.2 @PUTASEC ~ PUT A SECTOR 

The §PUTASEC routine puts (writes) from a specified memory buffer to a 
sector on a specified disk unit given the track and logical block numbers. 
Before it writes the sector it reads the header information of the target 
sector -2 to verify that it will be writing on the correct sector. This 
is called a preread. It requires that the preread sector be readable. 

It expects the unit number in the C register. 

It expects the track number in the D register and the logical block number 
in the E register. , 
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It expects the address In the HL register of the beginning of a 266 
byte buffer. 

If the routine detects an error it returns the carry flag set (C) and 
the error message code in the A register. 

4.3.5.3 WRITESECTOR - WRITE A SECTOR 

The IWRITESECTOR routine writes from a specified memory buffer to a 
sector on a specified disk unit given the track number and logical block 
number. It does not do a preread before writing. This" allows a sector 
to be written on an uninitialized track or a track on which the preread 
sector is unreadable. 

It expects the unit number in the C register. 

It expects the track number in the D register and the logical block 
number in the E register. 

It expects the address in the HL registers of the beginning of a 266 
byte buffer. 

If the routine detects an error it returns the carry flag set (C) and 
the error message code in the A register. 

4.3.5.4 laVERIFYSECTOR - VERIFY A SECTOR 

The iVERIFYSECTOR routine verifies the validity of the header information 
and checksum of a sector on a specified disk unit. 

It expects the unit number in the C register. 

It expects the track number in the D register and the logical block 
number in the E register. 

If the routine detects an error it returns the carry flag set (C) and 
the error message code in the A register. 

4.3.5.5 gSEEKTRACK - SEEK TO A TRACK 

The ©SEEKTRACK routine moves the read/write head to a specified track on 
a specified disk unit. 

It expects the unit number in the C register. 

It expects the track number in the D register. 

If the routine detects an error it returns the carry flag set (C) and 
the error message code in the A register. 

4.3.5.6 @RESTOREDISK - RESTORE THE READ/WRITE HEAD 

The (BRESTOREDISK routine positions the read/write head to track zero of 
a specified disk unit. 
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It expects the unit number in the C register. 

If the routine detects an error It returns the carry flag set (C) and 
the error message code in the A register. 

4.3.6 PROCESSOR ORIENTED UTILITY ROUTINES 

These subroutines effectively extend the instruction set of the 8080 to 
provide for some commonly required operations. 

When parentheses enclose an item in the following subs<»rtions, this 
indicates the contents of the memory location specified by the value 
within the parentheses. For example, HL=(HL) means that the HL register 
pair 1s replaced with the bytes at the address In HL and HL+1. If the 
HL registers contain the address 4000 hex, and at location 4000 there 1s 
a 01, and at location 4001 there is a 02, then the HL register would be 
replaced by 0201 hex. The low byte goes into L and the high byte into H. 

4.3.6.1 gHLADOA - ADD A TO HL 

The SHLADDA routine adds the unsigned 8 bit value in the A register to 
the unsigned 16 bit value in the HL registers. 

It expects a value in the HL, and the A registers. 

It returns HL=HL+A. 

It preserves the DE and BC registers. 

4.3.6.2 @INXM - INCREMENT HEMORY 

The SINXM routine increments a memory pair pointed to by the HL registers. 
It is similar to an INR M instruction but it operates on a byte pair 
(16 bits) In memory. 

It expects the address of the memory pair in the HL registers. 

It preserves the OE and BC registers and the PSW. 

4.3.6.3 9LHLINDEXED - LOAD HL INDIRECT INDEXED 

The ?LHLINDEXED routine loads the HL registers indirect from the location 
pointed to by the HL registers indexed by the A register. 

It expects the address in the HL registers, and the index In the A register. 

It returns HL=(HL+2*A). 

It preserves the DE and BC registers. 
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4.3.6.4 @LHLI - LOAD HL INDIRECT 

The @LHLI routine loads the HL registers with the content of the byte 
pair pointed to by the HL registers. 

It expects an address in the HL registers. 

It returns HL = (HL). 

It preserves the BC and DE registers. 

4.3.6.5 @TRANSDHC - TRANSFER FROM DE TO HL FOR A COUNT OF C 

The 8TRANSDHC routine copies a memory block pointed to by the DE 
registers to a menrory block pointed to by the HL registers for a length 
in the C register. It begins at the start of each block and working to 
the end. 

It expects the start address of the source block in the DE registers 
and the start address of the destination block in the HL registers and 
the number of bytes to copy in the C register. 

It returns (HL+0...+C) = CDE+0...+C). 

It preserves the 6 register. 

4.3.6.6 @TRANSDHBC - TRANSFER FROM DE TO HL FOR A COUNT OF BC 

The @TRANSDHBC routine copies a memory block pointed to by the DE 
registers to a memory block pointed to by the HL registers for a length 
in the BC registers. It begins at the start of each block and works to 
the end. 

It expects the start address of the source block in the DE registers 
and the start address of the destination block in the HL registers and 
the number of bytes to copy in the BC registers. 

It returns (HL+0.. .+BC) = (DE+0...+BC). 

4.3.6.7 0TRANSDHBCR - TRANSFER FROM DE TO HL FOR A COUNT OF BC REVERSE 

The @TRANSDHBCR routine copies a memory block pointed to by the DE 
registers to a memory block pointed to by the HL registers for a length 
in the BC registers. It begins at the end of each block and working to 
the beginning. 

It expects the start address of the source block in the DE registers 
and the start address of the destination block in the HL registers and 
the number of bytes to copy in the BC registers. 

It returns (HL+BC +0), = (DE+BC. ...+0). 
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4.3.6.8 @TRANSFILENAME - TRANSFER A FILENAME 

The iTRANSFILENAME routine copies a filename from one of the ASCII 
buffers (§ASCBUFF0 through §ASCBUFF3) to the laASCIIBUFF. 

It expects the (PASCBUFF number (ie. to 3) in the C register. 

It preserves the HL, OE, and BC registers. 

4.3.6.9 JFILLZER - FILL ZEROES 

The OFILLZER routine fills a block of memory up to 256 bytes in length 
with zeros. 

It expects the start address of the memory block In the HL registers 
and the number of bytes to fill in the B register. 

It preserves the DE and C registers. 

4.3.6.10@FILLSPC - FILL SPACES 

The (BFILLSPC routine fills a block of memory up to 256 bytes in length 
with spaces (hex 20). 

It expects the start address of the memory block in the HL registers 
and the number of bytes to fill in the B register. 

It preserves the DE and C registers. 

4.3.6.11 @FILLA - FILL FROM THE A REGISTER 

The SFILLA routine fills a block of memory up to 256 bytes in length 
with the value specified in the A register. 

It expects the start address of the memory block 1n the HL registers, 
the number of bytes to fill in the B register, and a fill value in the 
A register. 

It preserves the DE and C registers. 

4.3.6.12 @COMPARE - COMPARE HL TO DE 

The ^COMPARE routine compares the value in the HL registers to the 
value in the DE registers. 

It expects a value in the OE register and the value to compare it to in 
the HL register. The forms are like an 8080 CMP B instruction where DE 
is analogous to the A register and HL is analogous to the B register. 
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It returns the following sense: 

DE = HL zero flag set (Z), carry flag clear (NC) 

DE > HL zero flag clear (NZ), carry flag clear (NC) 

DE < HL zero flag clear (NZ), carry flag set (C) 

DE >=HL zero flag any state, carry flag clear (NC) 

It preserves the HL, DE, and BC registers. 

4.3.7 EXTENDED 8080 INTEGER ARITHMETIC (16 BITS) 

These routines extend the capability of the 8080 to allow 16 bit unsigned 
integer addition, subtraction, multiplication, and division (quotient, 
and modul us ) . 

The result of all of these routines is returned in the BC registers. The 
HL and DE registers are preserved. With the exception of §DEDIVHL and 
MEMODHL (divide and modulus routines), the carry flag is returned set (C) 
if a carry or borrow occurred. The divide and modulus routines return the 
carry unchanged. 

4.3.7.1 laPEADDHL - BC'DE^HL 

The ©DEADDHL routine performs 16 bit unsigned integer addition. 

It expects the addend in the DE register and the augend in the HL registers. 

It returns the sum in the BC registers and the carry clear (NC) unless 
a carry out of the high order bit occurs. 

It preserves the HL and DE registers. 

4.3.7.2 gPESUBHL - BC=DE-HL 

The ODESUBHL routine performs 16 bit unsigned integer subtraction using 
twos compliment addition. 

It expects the minuend in the DE registers the subtrahend in the HL registers. 

It returns the difference in the BC registers as a twos compliment number 
and the carry clear (NC) unless a borrow into the high order bit occurs. 

It preserves the HL and DE registers. 

4.3.7.3 eOEMULHL - BC=DE*HL 

The IDEMULHL routine performs 16 bit unsigned integer multiplication. 

It expects the multiplicand in the DE registers and the multiplier in the 
HL registers. 
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It returns the product in the 8C registers and the carry clear (NC) unless 
a carry out of the high order bit occurs. 

It preserves the HL and DE registers. 

4.3.7.4 (aPEDIVHl - BC=DE/Hl 

The iOEDIYHL routine performs 16 bit unsigned integer division. 

It expects the dividend in the DE registers and the divisor in the HL registers. 

It returns the integer quotient in the BC registers. 

It preserves the HL and DE registers. 

4.3.7.5 (apEWDHL - BC=DE%HL 

The fOEWDHL routine performs 16 bit unsigned integer division and returns 
the modulus (remainder) of the operation. 

It expects the dividend in the DE registers and the divisor in the HL registers. 

It returns the remainder of the division in the 8C registers. 

It preserves the HL and DE registers. 

Example: 5/2=2 and a remainder of 1. The quotient is the result of fOEDIVHL 
and the modulus (or remainder) is the result of §DEMODHL. 

4.3.8 MESSAGE OUTPUT SUBROUTINES 

These routines provide a simple means for outputing standard messages. 
Some of the routines access the system messages while others allow the user 
to set up a table of applications messages. The system messages are described 
in Section 4.8. 

4.3.8.1 ODISKERROR - DISK ERROR MESSAGES 

The iOISKERROR routine outputs system error messages related to disk operation. 
The routine closes all open disk files, outputs the appropriate error message 
to the console stream, and returns control to the MOOS executive which resets 
the 8080 stack to the MOOS system stack. 

It will output the appropriate error messages as detected by FILE MANAGEMENT 
and PHYSICAL DISK ACCESS routines (Sections 4.3.3 and 4.3.4) when they return 
a carry set (C) condition and an error message code in the A register. 

It expects the error message code in the A register. 

It DOES NOT RETURN. 
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4.3.8.2 gClQSEFILES - CLOSE ALL FILES 

The @CLOSEFILES routine closes all open files using the standard system 
file close routines. Any errors that are encountered will be reported on 
the console device. 
It always returns the carry flag clear (NC). 

It preserves the HL, OE and BC registers. 

4.3.8.3 @ERRORMES - ERROR MESSAGES 

The 0ERRORMES routine performs similarly to @OISKERROR except that 1t does 
not close all open files and it does return to the calling routine on exit. 

It expects the error message code in the A register. 

It preserves the C register. 

4.3.8.4 gWESSAGEOUT - MESSAGE OUTPUT 

The @MESSA6E0UT routine is a generalized message-table output routine. 
The user can provide his own applications message table and use this routine 
to output the messages to the console stream. The table may have variable 
length messages with imbedded blanks. Each message can be terminated with 
a control character or a character with the most significant bit set high. 
The control character will not be output. The character with the eighth 
bit high will be output after the bit is stripped. For example, an ASCII A 
is hex 41. CI hex is an ASCII A with the most significant bit high. 

It expects the message table's address in the HL registers. 

It expects the message's code in the A register. The code corresponds 
to the message's location in.the table, ie. , is the first message, 5 
is the sixth etc. 

It preserves the C register. 

4.3.9 SYSTEM BUFFERS AND ENTRY POIflTS 

These are miscellaneous entry points and buffers already described in detail 
in conjunction with other subroutines. 

@CONSOLEADDR - Contains the location of §CIOTABLE 

ILISTADD - Contains the location of (PLIOTABLE 

(PCIOTABLE - Start address of the console input/output vector table 

§LIOTABLE - Start address of the list input/output vector table 

iPCON - Start address of physical console driver routines 

@PLIST - Start address of physical list driver routines 
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iWARMSTART - Warm start entry point; initializes console and list devices, 
and prints the MDOS signon message. 

?MDOSEXECUTIVE - Entry point for MMS executive. Outputs the current MOOS 
executive prompt and initializes the MDOS stack. This entry does not output 
the signon message. 

§FILEBUFFER0 and §FILEBUFFER1 - 9FILEBUFFER0 and §FILEBUFFER1 are 288 byte 
buffers used by the system for file access. They may be used as applications 
program file buffers. See the section on FILE ACCESS ROUTINES. 

(PAPROGRAM - Address of the start of the applications area. The APP command 
transfers program control to this address. All file types except overlay 
(0C-0F hex) must have load addresses greater than or equal to 9APR0GRAM or 
a LOAD ADDRESS ERROR will occur when an attempt is made to load the file. 

@MASKADOR - A two byte pointer used by the ?SEAR routine. iMASKADDR points 
to the address of the mask string. 

iPARAMLEN - A one byte parameter used by the (aSEAR routine. It contains 
the length of the functions in the table to be searched. 

SMWSRETURN - Applications programs that have not changed the I/O initializa- 
tion return to this entry point instead of fWARMSTART. SMDOSRETURN outputs 
the MDOS signon message and initializes the MDOS stack but does not reinitialize 
the I/O handlers. 

The following buffers are used by the fPARAM routine and are discussed in 
detail there. 

1) One byte buffers which holds the number of specified parameters. 
(aNDRVPAR I3NASCPAR SNBINPAR 

2) Ten byte buffers which holds ASCII parameters. 

@ASC8UFF0 fASCBUFFl 

@ASCBUFF2 9ASCBUFF3 

3) One byte buffers which holds disk unit number parameters. 

§ORIVEN0 ©DRIVEN! 

9DRIVEN2 @DRIVEN3 

4) Two byte buffers which holds binary parameters. 

@BBUFF0 @BBUFF1 

@BBUFF2 @BBUFF3 

iASCIIBUFF - SASCIIBUFF is a ten byte buffer which holds filenames for 
the ^CREATE, ©RENAME, ©SCRATCH, and iTRANSFILENAME routines. 

©INBUFF - @INBUFF is the system input buffer. It is 132 bytes long. 
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4.4 LINEEDIT - THE MDOS LINE EDITOR 

LINEEDIT 1s an MOOS application program which provides assistance in 
creating and maintaining assembly language source program files that 
are compatible with the MDOS 8080/8085 assembler. It may also be used 
as a limited general text editor, 

LINEEDIT is invoked by typing LINEEDIT in response to an MDOS executive 
prompt or by typing the cotmnand LOAD "LINEEDIT" followed by the command 
APP. It signs on with the message MOOS LINE EDITOR VS. X.X. 

The user interacts with LINEEDIT through the system console. Lines 
entered at the keyboard may be text lines which are stored in the edit 
buffer or commands for LINEEDIT to execute. The general editing process 
consists of three parts. 

1) Placing a text file into the edit buffer by entering it a line 
at a time from the keyboard or by loading an existing file from 
disk. 

2) Modifying the text file In the edit buffer by adding, changing, 
and deleting lines. 

3) Storing the file in the edit buffer onto a disk. 

How to use LINEEDIT to carry out this process is described in the 
following sections. 

4.4.1 ENTERING LINES TO LINEEDIT 

After signing on LINEEDIT waits for a line to be input. A line consists 
of not more than 132 characters typed in sequence. The entry of a line 
is terminated by pressing the RETURN key. During the entry of a line 
each character that is typed is echoed by LINEEDIT on the console display. 
If more than 132 characters are typed prior to the RETURN, LINEEDIT will 
stop echoing characters and only honor a valid control function such as the 
RETURN. Characters which may be entered into a text line are ASCII 
characters in the code range 20H to 7EH with the exception of the backarrow 
(5FH). LINEEDIT also uses the MDOS console output system to keep track 
of the character count as a line is typed and automatically output a 
carriage return/line feed combination when the count exceeds the width of 
the display device. This combination is not included in the line count. 

Two control features may be used when entering a line. 

1 ) When DEL or RUBOUT key is pressed the next previously typed 
character will be deleted from the line. A backarrow is echoed 
to the terminal display for each character deleted. Neither the 
deleted characters nor the backarrow are Included in the line count. 
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2) Holding down the control key and typing X (CNTL/X) will cause 
all of the current line to be cancelled. A carriage return/line 
feed combination is echoed to the terminal display. LINEEDIT is 
positioned to accept entry of a new line. 

4.4.2 KEYING IN A NEW TEXT FILE 

LINEEDIT recognizes a line as a text file line by the presence of a 
leading line number. Each line number must be in the range to 9999. A 
text file is entered one line at a time using the normal line entry 
procedure. As each line is entered LINEEDIT stores it in the edit buffer 
which it maintains in the computer system's main memory. Text lines are 
stored in the edit buffer in numeric order by line number. The lines in 
the buffer at any given time constitute the current text file- 

To insert a new line in the current text file, type in the new line 
including the line number. LINEEDIT will automatically place the new 
line in the program buffer in proper sequence according to its line number. 

To replace an existing line in the current text file enter the line number 
and the new text. The new line will automatically replace the old line 
that has the same line number in the current text file. 

To delete one existing program line in the current text file type the 
line number and press the return key. The corresponding line will be 
eliminated from the current text file. Note that multiple lines may also 
be eliminated by using the DELT command as described in Section 4.4.13. 

Consecutive text lines may be entered conveniently by using LINEEDIT' s 
automatic line numbering feature. Prior to typing the first character 
of a new line, you can cause the 'next' line number to be generated for 
you by pressing the space bar one time. The 'next' line number will echo 
to the terminal display and LINEEDIT will then be waiting for the first, 
text character of that line. See Section 4.4.7 on the AUTO command to 
specify the increment that determines the 'next' line number. 

4.4.3 ENTERING LINEEDIT COMMANDS 

Whenever a line is typed which does not begin with a line numoer, 
LINEEDIT attempts to interpret this line as a command. If the line is 
not recognizeable as a LINEEDIT command, the message COMMAND NOT FOUND 
will be displayed. LINEEDIT commands are single words or abbreviations 
followed by parameters if required. All LINEEDIT commands are uppercase 
only. If the command requires one or more parameters, there must be at 
least one space between the command word and the first parameter and 
between each parameter. Parameters may be ASCII or numeric. ASCII 
parameters must be enclosed in double quotation marks except for within 
the SEARCH and CHANGE command dialogues. Numeric parameters are entered 
in decimal. LINEEDIT offers cormnands to facilitate the management of 
the editing process. 
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4.4.4 THE CLEAR COMMAND 

The edit buffer may be initialized to an empty state by using the CLEAR 
command. This command has no parameters. It Is entered by typing CLEAR 
and pressing the return key. 

Entering a CLEAR command may result in the message FILE ON DISK NOT UPDATED, 
PROCEED?. This is a warning that the contents of the current text file has 
not been stored on disk since it was last altered. When the message appears 
the current text file is not yet lost. To override this warning type Y 
and press the return key. The CLEAR conmand will be processed. Otherwise 
type N and press the return key. The message CANCELLED will be displayed 
and LINEEDIT will be waiting for an alternate corranand. 

When the CLEAR command is processed, LINEEDIT will display the message 
FILE NOT NAMED followed by two hex numbers which indicate that the edit 
buffer is empty and unnamed. 

4.4.5 THE NAME COMMAND 

The current text file in the edit buffer raay be named or renamed by using 
the NAME conmand. NAME "filename" is the general form of this command. 
The filename may be any valid MDOS filename. No disk drive unit number 
should be specified since this name is to be associated with the current 
text file in the edit buffer which is 1n the main system memory. When the 
NAME cormand is executed, LINEEDIT will display the new filename followed 
by two hex numbers which represent the beginning and ending addresses of' 
the current text file in memory. A text file may be keyed into the edit 
buffer before it is named. However, it cannot be stored on disk without 
being named. 

4.4.6 THE FILE COMMAND 

The name of the current text file and its address limits in memory can 
be determined by using the FILE conmand. This coimiand has no parameters. 
It is entered by typing FILE and pressing the return key. The name of the 
current text file will be displayed, followed by two hex numbers which are 
the starting and ending memory addresses of the current text file. If the 
current text file has not been named, the message FILE NOT NAMED will be 
displayed in place of the filename. 

4.4.7 THE AUTO COMMAND 

LINEEDIT' s automatic line numbering facility adds a fixed increment to 
the last entered line number in order to compute the 'next' automatic 
line number. When LINEEDIT is started this increment value is set at a 
default of 1. This value may be changed by using the AUTO comnand. The 
general form of the command Is AUTO number. The incrauent will be set 
to the decimal value of number. 
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4.4.8 THE PROMPT COMMAND 

When LINEEDIT is started its prompt message Is null. After processing 
an input line, it simply echoes a carriage return/line feed combination, 
and waits for a new input with the cursor at the left margin of the 
terminal display. A prompt character or message can be specified for 
LINEEDIT by using the PROMPT command. PROMPT "message" is the general 
form of this command. The message may be from 1 to 10 characters in 
length and include any characters valid in a text line. It must be 
enclosed in double quotes as shown. When the PROMPT command is executed, 
LINEEDIT will iirmediately display the new prompt at the left of the 
terminal display and be positioned waiting for a new input line. The 
LINEEDIT prompt may be restored to its initialized state by typing PROMPT 
and pressing the return key. 

4.4.9 THE LOAD COMMAND 

A text file may be loaded into the edit buffer from disk by using the 
LOAD command. LOAD "unit numberif ilename" is the general form of the 
coitmand. The double quotes must be used as shown. The filename must be 
a valid MOOS filename. The unit number is optional. If it is supplied, 
it must consist of a single digit from to 3 followed by a colon (:). 
It designates the disk unit on which the specified file is to be found. 
If no unit number is specified, unit is assumed. 

When a text file is successfully loaded, it replaces the contents of the 
edit buffer and all text from the previous text file in the buffer is 
lost. The name of the current text file becomes the name of the disk 
file that was loaded, not including the unit number. 

Entering a LOAD command may result in the message FILE ON DISK NOT UPDATED, 
PROCEED?. This is a warning that the current text file has not been stored 
on disk since it was last altered. When the message appears, the current 
text file is not yet lost. To override this warning type Y and press the 
return key. The LOAD command will be processed. Otherwise, type N and 
press the return key. The message CANCELLED will be displayed and LINEEDIT 
will be waiting for an alternate command. 

Entering a LOAD conmand may result in the message FILE BUFFER OVERFLOW. 
See Appendix for an explanation of this condition. 

4.4.10 THE APPEND COMWND 

A text file may be loaded from disk and appended to the end of the current 
text file in the edit buffer by using the APPEND command. APPEND "unit 
number:filename" is the general form of this command. The double quotes 
must be used as shown. The filename must be a valid MDOS filename. The 
unit number is optional. If it is supplied, it must consist of a single 
digit from to 3 followed by a colon (:). It designates the disk unit 
on which the specified file 1s to be found. If no unit number is specified, 
unit Is assumed. 
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When an APPEND is executed, the text file from disk is concatenated onto 
the end of the text file which was already in the edit buffer. The text 
lines of the appended file are not merged into the existing file in order 
by line number. The appended file may contain line numbers which conflict 
with the existing file. For these reasons it is important to use the RENUM 
command immediately after a successful APPEND. 

The name of the current text file in the edit buffer is not affected by 
an APPEND. 

Entering an APPEND command may result in the message WRONG FILE TYPE. 
This Is an indication that the requested file has an attribute type 
different than 4 through 7. These are the only valid source file types 
acceptable to LINEEDIT and the assembler. 

Entering an APPEND conmand may result in the message FILE BUFFER OVERFLOW. 
This is an indication that the amount of system memory available for the 
edit buffer is not enough to hold the additional file which was requested. 
When this condition occurs, the requested file is not appended but the 
existing is retained without change. 

4.4.11 THE SAVE COMWND 

The current text file in the edit buffer may be stored on disk as a new 
disk file by using the SAVE command. The general form of this command 
is SAVE unit number. The unit number is optional. If it is supplied, it 
must consist of a single digit from to 3. It designates the disk unit 
on which the current text file is to be stored. If no unit number 1s 
specified, unit is assumed. 

The name of the current text file in the edit buffer is used to create 
an entry in the directory of the specified disk and the text file is 
stored on the disk under that name. If the name already exists on the 
specified disk a DUPLICATE NAME message will result, and nothing will be 
written to disk. The edit buffer is unchanged. The file may be SAVEd by 
first changing its NAME to one that doesn't conflict or by using the 
RESAVE command if appropriate. 

A file created by the SAVE conwand is given the attribute type 4 which 
marks it as an editor/assembler source file. 

4.4.12 THE RESAVE COMMAND 

The current text file in the edit buffer may replace an existing file 
or disk by using the RESAVE command. The general form of this command 
is RESAVE unit number. The unit number Is optional. If it is supplied, 
it must consist of a single digit from to 3. It designates the disk 
unit on which the existing file to be replaced is found. If no unit 
number is specified, unit is assumed. 

The directory of the specified disk unit is searched for a filename 
which matches the name of the current text file in the edit buffer. The 
current text file is written over that file on the disk. If no match is 
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found, the message FILE NOT FOUND will be displayed. The current text 
file can be saved as a new file by using the SAVE command. If the file 
matched on disk has a type other than 4 through 7, the message WRONG 
FILE TYPE will be displayed. Text source files must have a source fi^e 
type. 

4.4.13 THE LIST COWHAND 

A formatted display of lines in the current text file can be output to 
the system console by using the LIST command. The forms of this command 
are LIST, LIST linenumberl, and LIST linenumberl linenumber2. The display 
will begin with linenumberl or the next highest and continue through 
linenumberZ or the next lowest. If linenumberl and Hnenumber2 are the 
same, only one line will be displayed. If linenumberZ is less than 
linenumberl, nothing will be displayed. If linenumberZ is not supplied, 
the display will begin with linenumberl or the next highest, and continue 
through the last line currently in the current text file. If no line 
numbers are supplied, the entire edit buffer will be displayed. 

The LIST command produces a formatted display of the text lines that is 
oriented to 8080 assembly language source text. The format is defined 
as four fields each beginning at a specific tab location. The first field 
begins at the left margin and displays the line number as a 4 digit number. 
The second field is the label field. It consists of all characters in the 
text line through the first space or colon (:) that occurs. The third 
field is the opcode and operands field. The opcode consists of all 
characters following the label field through the next occurrence of a space. 
The operand consists of all characters following the opcode through the 
next occurrence of a space. The fourth field is the comment field. It 
begins with a semicolon {;) following the space that terminates the operands 
and continues to the end of the text line. 

Refer to the TAB cotmiand to change the tab settings which determine the , 
placement of the fields for the LIST format. When using the LIST command 
with general text editing, it is advisable to set the tabs to 1 1 1. This 
effectively removes the tabulation effects which are designed for assembly 
language source text. 

4.4.14 THE LISTP COMMAND 

A formatted display of lines in the current text file can be output to 
the system printer by using the LISTP command. The forms of this command 
are LISTP, LISTP linenumberl, and LISTP linenumberl linenumberZ. 

The LISTP command functions the same as the LIST command except that output 
is directed to the system printer instead of the system console. 
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4.4.15 THE PRINT COMMAND 

A literal (unformatted) display of lines In the current text file can be 
output to the system console by using the PRINT comnand. The forms of this 
comnand are PRINT, PRINT linenumberl, and PRINT linenunierl linenumber2. 
The linenumber specifications in the PRINT comnand function the same as 
in the LIST comnand. 

The PRINT conmiand displays text lines as they are stored in the edit buffer 
but without the line numbers so that general text may be displayed just as 
it was entered. If an unformatted display of assembly language source 
text Is desired, it can be obtained by setting the tabs to 1 1 1 and using 
the LIST command. 

4.4.16 THE PRINTP COMMAND . 

A literal (unformatted) display of lines In the current text file can be 
output to the system printer by using the PRINTP command. The forms of 
this command are PRINTP, PRINTP linenumberl, and PRINTP linenumberl 
linenumber2. 

The PRINTP comnand functions the same as the PRINT command except that 
output is directed to the system printer instead of the system console. 

4.4.17 THE TAB COMMAND 

The tab settings that determine the placement of the fields for the LIST 
and LISTP format may be changed by using the TAB command. TAB numberl 
numberZ numbers Is the form of this cornnand. The first number is the 
column at which the opcode field begins. The second number Is the column 
at which the operand field begins. The third number is the column at which 
the comnent field begins. 

The initial and default values of the TAB parameters are 15, 22, 36 decimal. 
The settings may be reset to these values by typing TAB without any para- 
meters. Missing parameters are set to the default if possible or the value 
of the preceding parameter If that parameter 1s greater than the default 
value for that tab column. If TAB 17 were typed the tab setting would be 
17, 22, 36. TAB 25 would set the tabs to 25, 25, 36. 

4.4.18 THE DELT COMMAND 

A group of consecutive lines may be deleted from the current text file 
by using the DELT cotnnand. The forms of this command are DELT linenumberl, 
and DELT linenumberl 11nenumber2. Lines will be deleted from linenumberl 
or the next highest that exists, through Iinenuni3er2 or the next lowest that 
exists. If linenumber2 Is less than linenumberl nothing will be deleted. 
If they are equal only that line will be deleted. If only linenumberl 1s 
specified then only that line will be deleted. The edit buffer is 
automatically compressed whenever lines are deleted. 
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4.4.19 THE RENUM COMMAND 

All or part of the lines in the current text file can be renumbered by 
using the RENUM coimand. The forms of this command are RENUM, RENUM 
startingnumber, RENUM startingnumber increment, and RENUM startingnumber 
increment first-! ine-to-change. RENUM takes the line number of the first 
line to change and sets it equal to the starting number. The line number 
of each line after the first line to change is then set to the value of 
the preceding new line number plus the increment value. If no first line 
to change is specified, the first line in the edit buffer is assumed. If 
no increment value is specified, the valu2 10 is used. If no starting 
number is specified, the value is used. Typing RENUM alone will produce 
a text file numbered from by 10 's. 

Entering a RENUM conmand may result in the message LINE NUMBER OVERFLOW. 
This is an indication that the renumbering attempt lead to a line number 
greater than 9999. When this occurs the edit buffer is left In a partially 
renumbered state. Lines up to the overflow point have been renumbered but 
the ones after that point retain their old value. A RENUM with a smaller 
increment value should be executed immediately to correct this condition. 

4.4.20 THE SEARCH COMMAND 

Lines in the current text file that contain a specified string of text 
can be located and displayed by using the SEARCH conmand. The forms of 
this command are SEARCH, SEARCH linenumberl, or SEARCH linenumberl 
linenumberZ. SEARCH without a linenumber specified will search the whole 
buffer. SEARCH linenumberl will search from the line number specified 
to the end of the buffer. SEARCH linenumberl UnenumberZ will search the 
buffer starting at the first line specified through the second line 
specified. 

When the SEARCH command is entered, LINEEOIT will respond with the prompt 
SEARCH MASK ?. A string of up to 132 legal text line characters can be 
entered. The entry 1s terminated by pressing the return key. LINEEOIT 
searches through the lines in the current text file looking for the first 
occurrence within each line of a substring that matches the specified search 
mask. It examines every line except those lines that begin with an asterisk 
(*). Every examined line that contains a match is displayed on the system 
console. This display is a literal (unformatted) display including the line 
number. Lines with a leading asterisk (*) are considered comment lines in 
assembly language source text. Refer to the SEARCHALL command to operate 
on corranent lines. 

The SEARCH command also provides a universal match character capability. 
Each question mark (?) that is entered in the search mask string 1s treated 
as a match for any character in that position. For example, the search 
mask A?I will match all three character substrings that begin with A and 
end with I. Note that this capability means that question marks (?) 
included in the text cannot be explicitly searched for. . 

If no lines in the current text file contain a match to the specified 
search mask, the message STRING NOT FOUND will be displayed. 
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4.4.21 THE SEARCHALL COMMAND 

All lines in the current text file that contain a specified string of 
text, including those lines that begin with an asterisk (*} can be located 
and displayed by using the SEARCHALL command. 

The forms of this conmand are SEARCHALL, SEARCHALL linenumberl, or SEARCHALL 
linenumberl linenumberZ. SEARCHALL without a llnenumber specified will 
search the whole buffer. SEARCHALL linenumberl will search from the line 
number specified to the end of the buffer. SEARCHALL linenumberl linenumberZ 
will search the buffer starting at the first line specified through the 
second line specified. The SEARCHALL conmand functions the same as the 
SEARCH command except that all text lines including those that begin with 
an asterisk (*} are included in the search. 

4.4.22 THE CHANGE COMMAND 

The first occurrences of a specified string in lines of the current text 
file can be replaced with a different string of same or different length 
by using the CHANGE conmand. The forms of this command are CHANGE, CHANGE 
11nenuirt)erl , or CHANGE linenumberl linenunber2. CHANGE without a llnenumber 
specified will change all lines in the buffer. CHANGE linenumberl will 
change lines from the line number specified to the end of the buffer. CHANGE 
linenumberl linenumber2 will change lines in the buffer starting at the 
first line specified through the second line specified. 

CHANGE operates on all lines within the specified range except lines starting 
with an asterisk (*) or semicolon (;). These lines are considered comment 
lines in assembly language source text. Refer to the CHANGEALL command to 
operate on coninent lines. 

When the CHANGE command is entered, LINEEDIT will respond with the prompt 
SEARCH MASK ?. A string of up to 132 legal text line characters may be 
entered. The entry is terminated by pressing the return key. If no lines 
in the current text file contain a match to the specified search mask, the 
message STRING NOT FOUND will be displayed. Otherwise, LINEEDIT will then 
respond with the prompt CHANGE TO ?. Another string of up to 132 legal 
text string characters can be entered. The entry is terminated by pressing 
the return key. LINEEDIT searches through lines in the current text file 
looking for the first occurrence within each line of a substring that matches 
the specified search mask. It replaces such occurrences with the specified 
change-to string, adjusting line and buffer length accordingly. Each line 
as changed is displayed on the console without tabs expanded. 

The CHANGE conmand also respects the universal match character capability 
as described under the SEARCH command. If the search mask contains one or 
more question marks (?) these characters positions will match any character 
in the search process, and the matched substring will then be replaced by 
the change- to string. Example: 
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LIST 

13 SliLABELIA 

20 S2§LA8EL2A 

30 (3LABEL3 

CHANGE 

SEARCH MASK ? S?(? 

CHANGE TO ? 9 

10 iUBELlA 

20 @LABEL2A 

The change-to string may also contain question marks (?). This provides the 
ability to retain specified character positions in the search string while 
making changes on either or both sides of the retained character. Example: 

LIST 

10 TAG01A 

20 TAGOFF 

30 TA622A 

CHANGE 

SEARCH MASK ? TAG??A 

CHANGE TO ? LABEL??B 

10 LABEL01B 

30 LABEL228 

Lines 10 and 30 have been changed while line 20 is unchanged because it 
did not match the search string. The TAG at the beginning and the A at 
the end of lines 10 and 30 have been changed. The 01 in line 10 and the 
22 in line 30 have been retained. 

4.4.23 THE CHANGEALL COMMAND 

The first occurrences of a specified string in all lines of the current 
text file, including those lines that begin with an asterisk (*), or 
semicolon (j) can be replaced with a different string of same or different 
length by using the CHANGEALL comnand. The forms of this command are 
CHANGEALL, CHANGEALL linenumberl, or CHANGEALL linenumberl linenumber2. 
When the CHANGEALL command is entered it functions the same as the CHANGE 
command, except that all text lines including those that begin with an 
asterisk (*) are included in the search. 

4.4.24 THE EDIT COMWND 

The text within a specified line in the current text file can be changed 
without retyping the entire line by using the EDIT command. EDIT linenumber 
is the form of this command. If the specified linenumber is not found in 
the current text file, the nessage LINE NOT FOUND is displayed. LINEEDIT 

processes an EDIT command by copying the specified line into a special 
editing buffer and displaying the line number at the left margin of the 
console. An invisible edit pointer is set to point to the first character 
in the text line after the space that terminates the line number. LINEEDIT 
is now in the EDIT command mode. A separate set of single key commands is 
available for editing a line in the special edit buffer. 



Rev. 8 9/78 



4-52 



4.4.24.1 ADVANCING THE EDIT POINTER - THE SPACE BAR 

The invisible edit pointer in the special editing buffer may be advanced 
one position by pressing the space bar one time. The character to which 
the edit pointer is pointing will be displayed on the console. This 
indicates that the edit pointer has passed over the character. The edit 
pointer is then advanced so that it is now pointing at the next character 
in the text line inuiediately after the one that is displayed. The entire 
line can be displayed in this manner. 



4.4.24.2 CHANGING THE NEXT CHARACTER - C 

The character to which the edit pointer is pointing in the edit buffer 
can be changed by typing a c or C, followed by the new character. 
The new character is printed on the console and replaces the character 
in the edit buffer at that position. The edit pointer 1s advanced to 
point to the character inmediately after the new displayed character. 

4.4.24.3 DELETING THE NEXT CHARACTER - D 

The character to which the edit pointer is pointing in the edit buffer 
can be deleted by typing a d or 0. The deleted character is printed 
on the console enclosed in backslashes (/). The edit pointer is left 
pointing at the character immediately after the deleted character. 

4.4.24.4 INSERTING CHARACTERS - I 

Characters may be inserted into the line or at the end of the line by 
typing an i or I followed by the characters to be inserted. The 
insertion begins inrniediately before the character pointed to by 
the edit pointer. Characters are inserted in sequence as typed until 
the insert mode is terminated by. depressing the ESC key. The edit 
pointer remains pointing to the same character that it pointed to when 
the insertion began. The insert mode may also be terminated by pressing 
the return key. This also terminates the EDIT conmand and replaces the 
line in the current text file with the newly edited version from the 
special editing buffer. 

4.4.24.5 LISTING THE LINE IN THE SPECIAL EDITING BUFFER - L 

The remainder of the line in the special edit buffer from the position 
of the edit pointer to the end of the line may be displayed by typing 
an 1 or L. The characters are displayed on the console followed by 
a carriage return-line feed. The line number is reprinted at the left 
margin of the console display and the edit pointer is reset to the beginning 
position. This command is useful to see what the line looks like before 
editing is completed. It may also be useful to use this conroand immediately 
after entering the original EDIT command. This would display the line 
about to be edited without exiting the editing mode. 
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4.4.24.6 SEARCHING TO A SPECIFIED CHARACTER - S 

The edit pointer may be advanced in the special editing buffer to the 
first occurrence of a specified character by typing an s or S 
followed by the character to search for. The characters from the position 
of the edit pointer up to but not including the searched for character 
are printed on the console. The edit pointer is left pointing at the 
first occurrence of cne searched for character. If the search argument 
does not exist in the line then the entire line is printed and the edit 
pointer is positioned at the end of the line. 

4.4.24.7 DELETING TO A SPECIFIED CHARACTER - K 

Characters in the special editing buffer from the edit pointer position 
up to but not including a specified search character can be deleted by 
typing a k or K followed by the search character. The deleted 
characters are displayed on the console, enclosed in backslashes (/). 
If the search argument does not exist in the edit line, then all the 
characters from the edit pointer to the end of the line are deleted. 
The edit pointer is left pointing at the search character or at the end 
of the line. 

4.4.24.8 QUITTING THE EDIT COHMAND HODE - q 

The EDIT command may be aborted without changing the line in the current 
text file by typing a q or Q. The partially edited line in the 
special editing buffer is abandoned. No changes are made to the line in 
the current text file. LINEEDIT is ready to accept a new command. 

4.4.24.9 COMPLETING THE EDIT COMMAND - THE RETURN KEY 

The line in the special editing buffer can replace the line in the current 
text file at any point by pressing the return key. This terminates the 
EDIT command in a normal manner. 

4.4.25 THE DOS COMMAND - EXITING FROM LINEEDIT 

Control of the computer system can be returned from LINEEDIT to the MOOS 
executive by using the DOS conmand. This command has no parameters. It 
is entered by typing DOS and pressing the return key. Control is 
returned to the MDOS executive which signs on with the message MICROPOLIS 
MDOS VS. X.X. LINEEDIT remains in the system application program area and 
the contents of the current text file are not disturbed unless some action 
taken from the executive destroys these areas. Entering an APP command to 
the executive would return control to LINEEDIT. 

Entering the DOS command may result in the message FILE ON DISK NOT UPDATED, 
PROCEED?. This is a warning that the current text file has not been stored 
on disk since it was last altered. When the message appears the current 
text file is not yet lost. To override this warning type Y and press the 
return key. The DOS command will be processed. Otherwise type N and press 
the return key. The message CANCELLED will be displayed and LINEEDIT will 
be waiting for an alternate command. 
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4.4.26 LINEEDIT FILE STRUCTURE 

The current text file in the LINEEDIT edit buffer has the following 
fomat. Each line begins with a byte that contains a count of the number 
of bytes in the line. The count includes the count byte and the carriage 
return at the end of the line. The count byte is followed by four bytes 
that hold the digits of the line number in 'ASCII. The line number can 
range from 0000 to 9999. At least one space (20 hex) follows the line 
number. The remainder of the line can contain from to 125 characters 
followed by a carriage return. The shortest line contains 6 bytes. The 
longest line contains 132 bytes. The characters of the source program 
appear in the line exactly as they were typed during input. ASSM and 
LINEEDIT require only one space between elements of an assembly statement. 
Additional spaces are ignored. Therefore, there is no reason to type in 
more than the minimuin number of spaces when entering a source program. 
After the carriage return that terminates the last line of the current text 
file there is a byte that contains a 01 to mark the end of the file. 

The current text file is written to a disk file just as it appears in 
the edit buffer. All records in the disk file with the possible exception 
of the last one are full records. A text line may span two records. The 
following logic could be used in an MDOS application program designed to 
process an editor source file. 



1000 START 


CALL 


{3RFINXP0S1 


2000 


OCR 


C 


3000 


JZ 


ENDOFFILE 


4000 


MVI 


D,0 


5000 


MOV 


E.C 


6000 . 


LXI 


H, BUFFER 


7000 


CALL 


?LOADDATA 



8000 *PROCESS THE LINE IN THE BUFFER 
9000 JMP START 

The (PRFINXPOS routine gets the line count byte into the C register. If 
the count is 01 the end of the file has been reached. Otherwise, all 
program lines have a line length of no less than 6. The line length is 
nwved into the DE registers (D=0) and the buffer address is placed into 
the HL registers. The @LOADDATA routine starts at the index position 
and loads the next DE bytes into the buffer which leaves the index position 
pointing to the line count byte of the next text line. The program can 
then process the text line and loop back to get the next line. 
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4.5 ZSM - Z-80 ASSEMBLER 

ZSM is an MDOS program to convert Z-80 assembly language source code 
into object code, which consists of a sequence of binary codes that 
can be loaded into the computer's memory and executed. ZSM takes 
the place of ASSM, the earlier 8080/8085 assembler for MDOS. Any 
references in this manual to ASSM should be understood as references 
to ZSM. 

As input ZSM expects a type 4, 5, 6, or 7 text file, such as that 
produced by LINSSDIT. The output file produced will be a type 8 
file. This type of file may be scatter loaded into memory, meaning 
that it need not be contiguous code? rather, it can be several 
groups of individual code. 

Note that this is a disk assembler, so memory size is not a 
constraint on the size of file that may be assembled. 

ZSM is a copyrighted piece of software. Any reproduction or 
redistribution of It or this manual is expressly forbidden. 

4.5.1 HOW TO RUN ZSM 

ZSM is invoked from the MDOS executive by typing its name, followed 
by the assembly parameters. The format is as follows: 

> ZSM "<source filename>" "<object filename>" '•<optlons>" [<offset>l 

The <source filenames must be the assembly language source program 
as explained above. The <object filename> is the name of the output 
file. It must be included, but may be blank if the S or M option, 
below, is used. 

The <options> are instructions to ZSM pertaining to how to assemble 
the program. The number of options specified varies with what is 
desired and may be blank, but the field must nevertheless be 
included. The options are as follows. 

E Only lines containing assembly errors will be listed. 

P The assembly listing will be paginated. 

S The assembly listing will be produced, but no object code. 

M The object code will be written into memory, not to a disk 
file. 

L The line numbers from the source file will not appear on the 
listing. 

T The symbol table created by ZSM will be printed following 

the listing. 

"SM" is the only combination not allowable, since they are mutually 
exclusive. If they are both present, though, the S option will 
prevail . 
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The <offset> parameter indicates an offset to be added before the 
object code is placed into memory (via the M option). For example, 
it would be impossible to assemble a program into memory at 2B00, 
since that is where ZSM resides. Therefore, to put a program into 
memory that was designed to run at 2B00, you would have to specify 
an offset, for example 3000. This would result in code destined for 
2B00 to be actually put into memory at 5A00 (2B00 + 3000) . 

Here are some examples of valid commands: 



1. 


ZSM 


"SFILE" 


"OFILE" "" 


2. 


ZSM 


"SFILE" 


n w H pffic II 


3. 


ZSM 


"SFILl" 


"" "ML" 3000 


4. 


ZSM 


"SFILE" 


"OFILE" "E" 



Line 1 would assemble SFILE into the file OFILE, and produce a 
normal listing. Line 2 would assemble SFILE, producing a paginated 
listing Including a symbol table, but not produce an object file. 
Line 3 would assemble SFILE, putting the object code into memory 
with an offset of 3000; it would produce no object file; and it 
would produce a normal listing, but without line numbers. Line 4 
would assemble SFILE into the file OFILE, and only list those lines 
(if any) containing errors. 

Assembling a file with the M option in such a way that the operating 
system or assembler would be overwritten will cause a 'Load address 
error'. Including the wrong number of parameters in the command 
line, or forgetting a quote symbol, will cause a 'Syntax error'. 
Specifying an object file which already exists will cause a 
'Duplicate name' error, meaning there already exists a file with 
that name. Either SCRATCH that file, or select a new name for the 
object file. 

4.5.2 LANGUAGE ELEMENTS 

The source file has a general format as follows: 

#### LABEL: OPCODE OPERANDS ; comments 

The #### represents the four digit line number assigned each line by 
the line editor. Although the line number itself is ignored, it 
"must" be present, and must be four characters long, followed by a 

Sp3lC6 * 

The LABEL is optional. If present, it will be entered into the 
symbol table. Whether or not it is present, its position must be 
followed by a space or colon. That is, 

#### LABEL OPC or #### LABEL: OPC or #### OPC 

are valid, while 

#### OPC 
is not. 
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Labels may include any of the following characters: 

ABCDEFGHIJKLMNOPQRSTUVWXYZ 
abcdefghijklmnopqrstuvwxyz 
0123456789§. []{}\ | 



■% #■• — 



To avoid ambiguity, however, the first character may not be . or 
0-9. In addition, a label may be of any length up to 47 characters. 
All characters are significant. In normal use, though, up to 12 
characters should suffice; and over 14 characters will look a little 
strange on the listing. 

The OPCODE must either be a Z-80 opcode or a pseudo-op. Both are 
explained later. 

The OPERANDS vary. There can be any number of them, depending on 
whether they are operands for an opcode or a pseudo-op. There are 
also instances where there are no operands, and therefore this field 
can, in some cases, be omitted. If more operands are supplied that 
are needed, the extras are ignored. 

The COMMENT field is totally ignored by the assembler, except for 
printing it on the listing. Comments are used only for 
documentation or clarity, and can be omitted altogether. If 
present, comments should be preceeded by a semicolon (;) . The 
semicolon will cause a TAB to the third TAB setting, whereas its 
absence will result in the comment appearing immediately to the 
right of the operand field. 

There is one exception to the above format, and that is the case of 
an all-comment line. If the first character of the line (after the 
line number and space) is either an asterisk (*) or semicolon, the 
entire line will be treated as a comment. 

4.5.2.1 CONSTANTS 

ZSM provides for constants of two varieties, numeric and ASCII. 

ASCII constants are indicated by enclosing the appropriate character 
In single quotes (•). Any ASCII character can appear between the 
quotes, except for (1) control characters, having an ASCII code of 
under 20 hex; (2) the single quote character, ASCII code 27 hex; (3) 
the underscore character _, ASCII code 5F hex; and (4) the DEL 
character, 7F hex. 

Numeric constants may be in any of four bases - 2, 8, 10, and 16. A 
specific base is indicated as follows: 

###H indicates hexadecimal (base 16) - for example 1C7H 

###Q indicates octal (base 8) - for example 62Q 

###B indicates binary (base 2) - for example 10101B 

###D or just ### indicates decimal (base 10) - for example 193D or 

193 
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Regardless of base, all numeric constants ~must~ begin with a digit, 
0-9. (This is to prevent ambiguity with labels.) Thus A07 hex 
would have to be written as 0A07H. 

There is one special numeric constant, denoted by the symbol $. 
This constant is always equal to the address of the current line; 
that is, the memory location that the current line will be written 
into when it is loaded. Note that this reflects the address of the 
beginning of the current line, "not* the next line (as in some 
assemblers). As an example, consider that 



0010 



J MP 



would cause an infinite loop, since it would jump to itself. 



4.5.2.2 OPERATORS 

ZSM recognizes 10 operators. They are as follows: 

+ addition 

subtraction, or negative (as in -1) 

multiplication 

division 

modulo (remainder of division) 

logical AND 

logical OR 

logical EXCLUSIVE-OR 

rotate right (110101B>3 yields 101110B) 

rotate left (1110110B<1 yields 1101101B) 



/ 

% 
& 
I 

# 
> 
< 



All arithmetic operators treat their operands as unsigned 16--bit 
quantities, and answers are truncated to 16 bits. All logical 
operators perforin their function on a bit-by-bit basis, and they 
also treat their operands as 16-bit values. 

Operators combine with constants to form expressions. In an 
expression, all operators are evaluated in a strict left-to-right 
order, with no precedence of operators. 

Thus consider the following situation: 

TEST has been assigned the value 1000H. 
INC has been assigned the value 6. 

The expression encountered is TSST*6+INCI 7<8. 



The procedure would be TEST*6 (6000H) +INC {6p06H) 17 (6007H) <8 
(i760H) . Thus the resulting value is 760H. 



4.5.2.3 REGISTERS 

The Z-80 has a number of registers, all of which have a specific 
symbolic reference. ZSM supports these references, as follows. 
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register designation 

register B - B Also called BC for register-pair instructions 

register C - C 

register D-D Also called DE for register-pair instructions 

register E - E 

register H - H Also called HL for register-pair instructions 

register L - L 

accumulator- A 

memory - M Also called (HL) , but ZSM does not allow this. 

A St flags - PSW Program Status Word, may also be called AF 

Stack Ptr - SP 

Index reg X- IX Also may be called X for brevity 

Index reg Y- lY Also may be called Y for brevity 

Of course, the Z-80 also has registers A', B', C , D' , E', H' , L', 
F' , PC, I, and R, but these are never explicitly referred to in an 
instruction, so no special designation is needed. 

4.5.2.4 PSEUDO-OPS 

ZSM supports a large number of pseudo-ops. They will be explained 
now. 

ORG Set origin 

The ORG pseudo-op specifies where the object code is to be put. 
Assembled code and data is assembled starting at the address 
specified as the operand to the ORG psuedo-op, and proceeds upward, 
until the end of the program or another ORG. A program can contain 
as many ORGs as desired. Since ORG is handled in pass 1, any symbol 
appearing in the operand must already be defined. 

LINK Link to a file 

The LINK pseudo-op allows separate program files on the disk to be 
'linked together' and assembled as one file. The LINK operand is a 
source file name, enclosed in single quotes. No drive specification 
is needed for the LINK file, as all units will be searched (starting 
with the unit the original source file is on) to locate the file. 
If the file is not found, a 'File not found' error will be issued, 
and the assembly aborted. 

Linking to a file is like a subroutine; that is, when the linked-to 
file is exhausted, assembly of the original program will continue 
from where it was left off at. For example, 

0010 LXI H,4000H 

0020 LINK 'TEST' 

0030 MOV A,M 

will cause the entirety of the file TEST to be assembled between the 

LXI and the MOV. 

Files that are linked to must not contain an END pseudo-op. 
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END End of assembly 

The END pseudo-op indicates to ZSM that the end of the program has 
been reached. As such, it may be omitted, since the physical end of 
a program has the same effect. 

In addition, though, an operand may be included. This operand, if 
present, indicates the starting address of the program. This 
address is not where the program is loaded, but instead where 
execution will begin. This allows the program to begin execution at 
any point in memory, rather than the beginning of the program. If 
this is omitted, then the beginning of the program is used as the 
starting address. 

In order for the starting address to be effective, the object file 
would be changed to an implicit command file under MDOS (type 
0C-0F) . 

EQU Equate 

The EQU pseudo-op simply equates the label associated with it to the 
value of the operands. 

0010 TEN EQU 10 

0020 TWENTY EQU 2*10 

The above code would cause the label TEN to have the value 10, and 
TWENTY to have the value 20. 

REQ Request value 

The REQ pseudo-op is similar to the EQU pseudo-op, only instead of 
an explicit value being specified, the system console is prompted 
for the value. The prompt is specified as the operand. For 
example, 

0010 TEST REQ 'Input:' 

Would cause the message 

Input: 

to be displayed on the console during pass 1 of the assembly. The 
operator must then type the value to be associated with the label. 
For example, if the operator had typed '56H' in response to the 
prompt, then TEST would have a value of 56 hex. 

PRT Print 

The PRT pseudo-op allows information to be displayed on the console 
during pass 2. If operands are present, they are displayed, 
otherwise, just a carriage return/linefeed is printed. For 
example. 
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0010 TEST EQU 7000H 

0020 PRT 'This is a test ' ,TEST 

would cause 

This is a test 7000 

to be printed on the console during pass 2. 

TAB Tab settings 

The TAB pseudo-op changes the tab settings for the assembly listing. 
Normally, they are at positions 15, 22, and 36. If it is desired to 
change them, then the TAB pseudo-op is used. It expects three 
operands, one for each tab setting. If a particular operand is 
zero, then that position is set to the default. The three settings 
represent the location of the opcode, operand, and comment fields 
respectively. 

NLIST No list 

The NLIST pseudo-op will cause code following it not to be listed. 
Note that this overrides any options which may have been specified 
in the command string; If the E option was used, nothing will be 
listed (errors or not) after a NLIST. 

LIST List 

The LIST pseudo-op cancels the effect of the NLIST pseudo-op. If 

there has been no NLIST, then this has no effect. 

FORM Form feed 

The FORM pseudo-op produces a formfeed in the listing when 
encountered. 

IFF If false - conditional assembly 

The block of code following the IFF pseudo-op will be assembled only 
if the operand evaluates to 0. 

IFT If true - conditional assembly 

The block of code following the IFT pseudo-op will be assembled only 
if the operand evaluates to anything other than 0. 

ENDIF End of IF block 
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The ENDIF pseudo-op is used to mark the end of an IFT or IFF block. 

DB Define byte 

The DB pseudo-op assigns its operands to successive memory 
locations. Either numeric or ASCII operands may be present, but 
either one must evaluate to only 8 bits. This means that only one 
ASCII character may be included per operand. For example, 

0010 LOCATION DB 1 ,20H,11B , ' D' ,TEST,14 

would put each operand into a successive memory location. 

•Z' is a special case of the DB pseudo-op, and it is equivalent to 
DB 0. For example, 

0010 XXX Z and 

0010 XXX DB 

are equivalent. 

DW Define word 

The DW pseudo-op is basically similar to DB , only it defines two 
bytes at a time, rather than 1. Also, the two bytes are in Intel 
standard low/high format. 

DO Define data 

The DD pseudo-op is exactly like DW, only the two bytes are put in 
high/low format. 

DT Define text 

The DT pseudo-op allows ASCII text to be put Into memory. The 
desired text must be enclosed by single quotes. For example, 

0010 TEST DT 'ABCDEF' 

would produce the following object code: 41 42 43 44 45 46 (hex). 

DTH Define text terminated high 

The DTH pseudo-op is like DT, only the last character is ORed with 
80H before it is written out. In the above example, the last byte 
would be C6 hex. 

DTZ Define text terminated with 2ero 

The DTZ pseudo-op is like DT also, only it causes a byte of 00 to be 
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appended to the text string. Thus the example would be 41 4 2 4 3 44 
45 46 00. 

DS Define storage 

The DS pseudo-op causes the assembler to skip over the number of 
bytes specified by the operand. Since the object file is scatter 
loaded, the area skipped over will remain undisturbed. 

FILL fill storage 

The PILL pseudo-op is similar to DS, only it fills the area with a 
constant, rather that skipping over it. The constant to fill with 
is specified with the second operand. For example, 

0010 FILL 5,3 

would produce the output 

03 03 03 03 03. 

4.5.3 ASSEMBLY ERRORS 

There are ten assembly errors. Note that an error doesn't 

necessarily cause the program to assemble wrong, particularly if the 

error is a syntax error in something like a TAB statement. 
Nevertheless, all errors should be avoided. 

The errors are as follows. 

A Argument error - This is caused by an invalid character in an 
operand field, or an ASCII constant which is out of range. 

D Duplicate label error - This indicates that a symbolic name 
was used more than once as a label. The first value will be used. 

J Jump error - This indicates a relative jump (JR, JRZ, JRNZ , 
JRC, JRNC, DJNZ) to a label which is out of range. The relative 
jump should be replaced with an absolute one. 

L Label error - This is caused by a label which contains invalid 
characters. 

M Missing label error - This indicates that an EQU or REQ 
pseudo-op was encountered, but there was no label on the line. 
Obviously, a label is necessary for either of these. 

Opcode error - This is caused by an illegal or missing 
opcode. 

R Register error - This indicates that an illegal value was 
found where a register was expected. 
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S Syntax error - This is caused by missing operands or improper 
use of operators. 

U Undefined symbol error - This indicates that a symbol was 
used, but that the symbol has not been defined. 

V Value error - This indicates that the value computed is out of 
range for the operation being used, specifically a two-byte 
instruction, or a DB. 

4.5.4 INSTRUCTION SET 

ZSM supports the complete Z-80 instruction set, using the TDL-style 
mnemonics. These mnemonics represent the Z-80 instruction set as a 
logical superset of the 8080 mnemonics. The reason that these 
'superset' mnemonics were chosen over the Zilog mnemonics is for 
ease of use. All 8080 programs will run unmodified on ZSM, but they 
wouldn't on a Zilog-mnemonic assembler. In addition, someone 
familiar with 8080 mnemonics will find the superset easy to learn, 
since they are a logical extension of 8080 mnemonics. 

One thing that is important to grasp is how indexing is handled. 

Under Zilog mnemonics, an operand might appear as (IX+d) v^here d is 

the offset and IX is the index register. Under ZSM, it would be 
d(X). Thus instead of 

0010 LD HL,(IX+12) 

the following notation is used: 

0010 LXI H,12(X) 

The same is true of lY, only it would appear as (Y) instead of (X) . 
In addition, an offset of zero may be omitted entirely. That is, 
(IX+0} needn't be written as 0(X), it can simply be (X) . 

The next sections outline the instruction set. It is not meant as a 
tutorial on the Z-80, but rather a guide to the speci'fic mnemonics 
used. Following that is a test program. If you have a Mostek or 
Zilog Z-80 Programming Manual, notice that in the back is an 
alphabetic list of all possible instructions. That list is in Zilog 
mnemonics. The test program herein is an exact duplicate of that 
list, only in the superset mnemonics. You are not expected to enter 
and assemble this program, but to use it as reference for the 
mnemomics. 

In the following section, certain general conventions are used. 
They are as follows: 

n an 8 bit value 

nn a 16 bit value 

d an 8 bit value, specifically a displacement 

r register, such as A, B, C, D, E, H, L, M, d(X), d{Y) 

I one of the index registers, IX or lY (abbreviated X or Y) 

rp register pair, such as B, D, H, SP, PSW, IX, lY 
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a bit, value 0-7 
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8 bit load group 
Instruction 



HOV 


r,r 


MOV 


r.M 


MOV 


r,d(I) 


MOV 


M.r 


MOV 


d(I),r 


MVI 


r,n 


MVl 


M.n 


MVI 


d(l),n 


LDA 


nn 


STA 


nn 


LDAX 


rp 


ST AX 


rp 


LDAI 




LDAR 




LDIA 




LDRA 





Zilog equivalent 



LD 


r,r 


LD 


r,(HL) 


LD 


r,(I+d) 


LD 


(HD.r 


LD 


(I-t-d),r 


LD 


r,n 


LD 


(HL),n 


LD 


(I+d),n 


LD 


A,(nn) 


LD 


(rm),A 


LD 


A,(rp) 


LD 


<rp),A 


LD 


A, I 


LD 


A,H 


LD 


I. A 


LD 


R,A 



16 bit load group 
Instruction 
LXI rp,nn 



nn 
nn 
nn 



nn 
nn 

nn 



LBCD 
SBCD 
LDED 
SDED nn 
LHLD nn 
SHLD nn 
LSPD 
SSPD 
LIXD 
SIXD nn 
LIID nn 
SIYD nn 

SPHL 
SPIX 
SPIY 

PUSH rp 
POP rp 



Zilog equivalent 

LD rp.nn 



LD 


BC,(nn) 


LD 


(nn),BC 


LD 


DE,(nn) 


LD 


(nn) ,DE 


LD 


HL,(nn) 


LD 


(nn) ,HL 


LD 


SP,(nn) 


LD 


(nn),SP 


LD 


IX, (nn) 


LD 


(nn),IX 


LD 


IY,(nn) 


LD 


(nn) ,11 


LD 


SP,HL 


LD 


SP.IX 


LD 


SP.IY 


PUSH 


rp 


POP 


rp 
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Exchange, block transfer, and search group 
Instruction Zllog equivalent 



XCHG 

SXAF 
SXX 
XTHL 
XTIX 

LDI 
LDIR 
LDD 
LDDR 

wVrfX 

CCIR 

CCD 

CCDR 



EX 


DE.HL 


EX 


AF,AF' 


EXX 




EX 


(SP),HL 


EX 


(SP),IX 


EX 


(SP),II 


LDI 




LDIR 




LDD 




LDDR 




CPI 




CPIR 




CPD 




CPDR 





Input . 


/ Output 


group 






Instruction 




Zilog eq 


uivale: 


IN 


n 




IM 


A,n 


OUT 


n 




OUT 


n,A 


INP 


r 




IN 


r,(C) 


OUTP 


r 




OUT 


(C),r 


INI 






INI 




INIH 






INIR 




IND 






IHD 




INDR 






INDR 




OUTI 






OOTI 




OUTIR 






OTIR 




OUTD 






OOTD 




OUTDR 






OTDR 
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8 bit airthmetic/logical group 



nstn 

ADD 


jction 

r 


ADD 


M 


ADD 


d(I) 


ADI 


n 


ADC 


r 


AC I 


n 


SUB 


r 


SUI 


n 


S3B 


r 


SBl 


n 


ANA 


r 


ANI 


n 


ORA 


r 


ORl 


n 


XHA 


r 


XRI 


n 


CMP 


r 


CPI 


n 


INR 


r 


DCH 


r 



Zilog equivalent 



ADD 
ADD 
ADD 
ADD 

ADC 
ADC 

SUB 
SUB 

<9Sv 

SBC 

AND 
AND 

OB 
OR 

XOR 
XOR 

CP 
CP 

INC 
DEC 



A,r 
A,(HL) 
A.d+d) 
A,n 



A.r 
A,n 

k,r 
A,n 

A.r 
A,n 

A,r 
A,n 

A.r 

k,a 

A,r 
A,n 

A,r 
A,n 

r 
r 



(references to M and d(I) are like ADD) 



lb bit arithmetic group 



Instruction 


DAD 


rp 


DA DC 


rp 


DSBC 


rp 


DADX 


rp 


DADY 


rp . 


INX 


rp 


DCX 


rp 



Zilog equivalent 

ADD HL.rp 
ADC HL.rp 
SBC HL,rp 

ADD IX ,rp 
ADD II , rp 



INC 
DFC 



rp 

rp 
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General purpose arlthaetlc and control group 



Instruction 


Zilog equivalent 


DAA 


DAA 




CMA 


CPL 




NEG 


NEG 




CMC 


CCF 




STC 


SCF 




NOP 


NOP 




HLT 


HALT 




DI 


DI 




EI 


EI 




IMO 


IH 





IM1 


IM 


1 


IM2 


IM 


2 
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Rotate and shift group 



nstruction 


RLC 




RAL 




RRC 




RAR 




RLCR 


r 


RLCR 


M 


RLCR 


dd) 


RALR 


r 


BRCR 


r 


RARR 


r 


SLAR 


r 


SRAR 


r 


SRLR 


r 


RLD 




RRD 





Zilog equivalent 



RLCA 




RLA 




BRCA 




BRA 




RLC 


r 


RLC 


(HL) 


RLC 


(I+d) 


RL 


r 


RRC 


r 


RR 


r 


SLA 


r 


SRA 


r 


SRL 


r 


RLD 




RRD 





(references to H and d(I) are like RLCR) 



Bit manipulation group 



Instruction 


BIT 


b,r 


BIT 


b,M 


BIT 


b,d(I) 


RES 


b,r 


SET 


b.r 



Zilog equivalent 



BIT 


b,r 


BIT 


b,(HL) 


BIT 


b,(I+d) 


RES 


b.r 




(r 


SET 


b,r 



(references to M and d(l) are like BIT) 
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Jump, call, and return group 
Instruction Zilog equivalent 



JMP 


nn 






JP 


nn 


JZ 


nn 






JP 


Z,nn 


JNZ 


nn 






JP 


NZ.nn 


JC 


nn 






JP 


C,nn 


JNC 


nn 






JP 


NC,nn 


JPO 


nn 


(or 


JNO) 


JP 


PO,nn 


JPS 


'nn 


(or 


JO) 


JP 


PE.nn 


JM 


nn 






JP 


M,nn 


JP 


nn 






JP 


P,nn 


JR 


nn 


(or 


JMPR) 


JR 


d 


JRZ 


nn 






JB 


Z,d 


JRNZ 


nn 






JR 


NZ,d 


JRC 


nn 






JR 


C.d 


JRNC 


nn 






JR 


NC.d 


DJM2 


nn 






DJNZ 


d 


PCHL 








JP 


(HL) 


PCIX 








JP 


(IX) 


pen 








JP 


(II) 


GALL 


nn 






CALL 


nn 


CZ 


nn 






CALL 


Z.nn 


CNZ 


nn 






CALL 


NZ.nn 


CC 


nn 






CALL 


C,nn 


CNC 


nn 






CALL 


NC ,nn 


CPO 


nn 


(or 


cm) 


CALL 


PO.nn 


CPE 


nn 


(or 


CO) 


CALL 


PE,nn 


CM 


nn 






CALL 


M,nn 


CP 


nn 






CALL 


P,nn 


RET 








RET 




RZ 








RET 


Z 


RMZ 








RET 


N2 


RC 








RET 


C 


RNC 








RET 


MC 


RPO 




(or 


RNO) 


RIT 


PO 


RPE 




(or 


RO) 


RET 


PE 


RM 








RET 


M 


RP 








RET 


P 


RE^l 








RETI 




RETN 








RETN 





RST 



RST 



m (a s 8 • n) 
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4-67 D 



Page 1 



Page 2 



Addr B1 B2 B3 Bt E Line Label 



Opod Operand 



Addr B1 B2 B3 64 E Line Label 





0000 




0001 i 




0000 




0002 J 




0000 




0003 ! 




0000 




0004 i 




0000 




0005 i 




0000 




0006 j 




0000 8E 




0007 A 




0001 DO 8E 05 


0008 




OOOil FB Be 05 


0009 




0007 8f 




0010 




0008 88 




0011 




0009 89 




0012 




oooA a A 




0013 




OOOB 8b 




0014 




OOQC 8c 




0015 




OfiOD 8D 




0016 




OOOB CE 


20 


0017 




0010 ED 


4A 


■ 0018 




0012 BD 


5A 


0019 




0011) ED 


6A 


0020 




0016 BD 


7A 


0021 


*>. 


0018 




0022 i 


0018 86 




0023 A 


<Ti 


0019 DD 86 05 


0024 


-J 


001C FD 


86 05 


0025 


M 


001F 87 




0026 




0020 80 




0027 




0021 81 




0028 




0022 82 




0029 




0023 83 




0030 




00211 84 




0031 




0025 85 




0032 




0026 C6 


20 


0033 




0028 09 




0034 




0029 19 




0035 




002A 29 




0036 




0028 39 




0037 


fD 


002C DD 


09 


0038 


002E DD 


19 


0039 


< 


0030 DD 


29 


0040 


m 


0032 DD 


39 


0041 


00 


0034 FD 09 


0042 


0036 FD 


19 


0043 


(-" 


0038 FD 29 


0044 




003A FD 


39 


0045 




003C 




0046 i 


K3 


003C A6 




0047 A 


U1 


00 3D DD 


A6 05 


0048 


\ 


0040 FD 


A6 05 


0049 


-4 


0043 A7 




0050 


^ 


0044 AO 




- 0051 




0045 A1 




0052 




0046 42 




0053 




0047 A3 




0054 




0048 A4 




0055 




0049 A5 




0056 



Teat file for ZSM 
by Neale Brasaell 

This uaea all Inatructlona 

,0000 



,0018 



00 3C 



ADC 


H 


ADC 


IHD(X) 


ADC 


IND(Y) 


*0C 


A 


ADC 


b 


ADC 


C 


ADC 





ADC 


B 


ADC 


H 


ADC 


L 


ACI 


N 


DADC 


B 


DAbC 


D 


DADC 


H 


DADC 


SP 


ADD 


H 


ADD 


IND(X) 


ADD 


IND(Y) 


ADD 


A 


ADD 


B 


ADD 


C 


ADD 


D 


ADD 


E 


ADD 


H 


ADO 


L 


ADI 


N 


DAD 


B 


DAD 


D 


DAD 


H 


DAD 


SP 


DADX 


B 


DADX 


D 


DADX 


X 


DADX 


SP 


DADI 


B 


DADSf 


D 


DADX 


I 


DADY 


SP 


ANA 


H 


ANA 


IND(X) 


ANA 


IND(]f) 


ANA 


A 


ANA 


B 


ANA 


C 


ANA 


D 


ANA 


E 


ANA 


H 


ANA 


L 



004A E6 20 




0057 


004C 




0058 i 


004C CB 46 




0059 A.004C 


004E DD CB 05 


46 


0060 


0052 FD CB 05 


46 


0061 


0056 CB 47 




0062 


0058 CB 40 




0063 


005A CB 41 




0064 


005C CB 42 




0065 


005E CB 43 




0066 


0060 CB 44 




0067 


0062 CB 45 




0068 


0064 




0069 i 


0064 CB 4E 




0070 


0066 DO CB 05 


4E 


0071 


006 A FD CB 05 


4E 


0072 


006E CB 4F 




0073 


0070 CB 48 




0074 


0072 CB 49 




0075 


0074 CB 4A 




0076 


0076 CB 4B 




0077 


0078 CB 4C 




0078 


007A CB 4D 




0079 


007C 




0080 i 


007C CB 56 




0081 


007E DD CB 05 


56 


0082 


0082 FD CB 05 


56 


0083 


0086 CB 57 




0084 


0088 CB 50 




0085 


008a CB 51 




0086 


008C CB 52 




0087 


008E CB 53 




0088 


0090 CB 54 




0089 


0092 CB 55 




0090 


0094 




0091 i 


0094 CB 5E 




0092 


0096 DD CB 05 5E 


0093 


009A FD CB 05 


5E 


0094 


009E CB 5F 




0095 


OOAO CB 58 




0096 


0OA2 CB 59 




0097 


00A4 CB 5A 




0098 


00A6 CB 5B 




0099 


00A8 CB 5C 




0100 


00 A A CB 5D 




0101 


OOAC 




0102 i 


OOAC CB 66 




0103 


OOAE DD CB 05 


66 


0104 


00B2 FD CB 05 


66 


0105 


00B6 CB 67 




0106 


00B8 CB 60 




0107 


OOBA CB 61 




0108 


OOBC CB 62 




0109 


OOBE CB 63 




0110 


OOCO CB 64 




0111 


0OC2 CB 65 




0112 



Oped 


Operand 


ANI 


N 


BIT 


O.M 


BIT 


0,IND(X) 


BIT 


0,IND(Y) 


BIT 


0,A 


BIT 


O.B 


BIT 


O.C 


BIT 


0,D 


BIT 


0,E 


BIT 


0,H 


BIT 


O.L 


BIT 


1,H 


BIT 


1,IN0(X) 


BIT 


1,IND{!f) 


BIT 


1,A 


BIT 


1,B 


BIT 


1,C 


BIT 


1,0 


BIT 


1,E 


BIT 


1.H 


BIT 


1,L 


BIT 


2,M 


BIT 


2,IND(X) 


BIT 


2,IND(5f) 


BIT 


2, A 


BIT 


2,B 


BIT 


2,C 


BIT 


2,D 


BIT 


2,E 


BIT 


2,H 


BIT 


2,L 


BIT 


3.M 


BIT 


3,IHD(X) 


BIT 


3,im(t) 


BIT 


3,A 


BIT 


3.B 


BIT 


3.C 


BIT 


3,D 


BIT 


3,E 


BIT 


3.H 


BIT 


3,L 


BIT 


4,M 


BIT 


4,IHD(X) 


BIT 


4,IND(¥) 


BIT 


4, A 


BIT 


4:b 


BIT 


4,C 


BIT 


4,D 


BIT 


4,E 


BIT 


4,H 


BIT 


4,L 



rage 3 



Pag« H 



< 






-a 

U3 



1 

~4 



Addr B1 


32 


B3 BH : 


: lir.* Lacel 


OOC»l 






0113 i 


OOCil CB 


6E 




OHM 


00C6 DD 


CB 


05 6E 


0115 


OOCiS FD 


CB 05 6E 


0116 


OOCE CB 


6F 




OH' 


OODO CB 68 




0119 


00D2 CB 69 




0119 


OODI CB 6i 




0120 


0006 CB 6b 




0121 


0ac8 CB 


6C 




0122 


OOD* CB 6D 




0123 


OOSC 






012« i 


OODC CB 


'6 




0125 


OODE 00 


CB 05 76 


0126 


00E2 FO 


CB 05 76 


0127 


00E6 CB 


77 




0128 


00E8 CB TO 




0129 


OOEA CB 71 




0130 


OOEC C9 72 




0131 


OOEE CB 73 




0132 


OOFO CB 7« 




0133 


00F2 CB 75 




0131 


OOFJl 






0135 i 


OOF* CB 


7e 




0136 


00F6 DD 


CB 05 7E 


0137 


OOFA FD 


CB 05 7E 


0136 


OOFE CB 7f 




0139 


0100 CB 76 




oito 


0102 CB 


79 




Oltl 


010* CB 71 




011)2 


0106 CB 7B 




0143 


0108 CB 7C 




OW 


OlOA CB 70 




OIW 


010C 






0146 i 


010C DC 


88 


05 


0147 *,010C 


OlOF FC 


88 05 


0148 


0112 01 


88 


05 


0149 


0115 CD 


88 


05 


0150 


0118 C* 


88 05 


0151 


OllB rt 


68 


05 


0152 


OllE EC 


88 


05 


0153 


0121 E* 


88 


05 


0154 


0121 CC 


88 


05 


0155 


0127 






0156 J 


0127 3f 






0157 A. 0127 


0128 






0156 i 


0128 BE 






0159 A. 0128 


0129 DD 


BE 


05 


0160 


012C PD 


BE 


05 


0161 


012F BF 






0162 


0130 Bb 






0163 


0131 B9 






01o4 


0132 6* 






dlt>5 


0133 BB 






ilioc 


'1 BC 






aio'' 


J BU 






OloS 



Oped .'.i-erand 



BIT 


5,M 


BIT 


5,IND(X) 


BIT 


S.INOd) 


BIT 


5. A 


BIT 


5,B 


BIT 


5.C 


BIT 


5,0 


BIT 


5.E 


BIT 


5,M 


BIT 


5,L 


BIT 


6,H 


BIT 


6,IN0(X) 


BIT 


6,IN0(K) 


BIT 


6, A 


BIT 


6.1 


BIT 


6.C 


BIT 


6,0 


BIT 


6,E 


BIT 


6.H 


BIT 


6.L 


BIT 


7,M 


BIT 


7,IHD(1) 


BIT 


7,IND(!f> 


BIT 


7.* 


BIT 


7,B 


BIT 


7,C 


BIT 


7,0 


BIT 


7,E 


BIT 


7.H 


BIT 


7,L 


CC 


NN 


CH 


NN 


CMC 


NN 


CALL 


NM 


CNZ 


NN 


CP 


NN 


CPE 


NN 


CPO 


NN 


cz 


NN 



CMC 



CMP 


M 


CMP 


IND(X) 


CMP 


INDiK) 


CMP 


A 


CMP 


B 


CMP 


C 


CMP 


D 


CMP 


E 


CMP 


a 


CHP 


I 



Addr Bl 


fa2 E3 B4 


e line Label 


Opod 


Operand 


0136 F£ 


20 


0169 




CPI 


N 


0138 




0170 i 








0138 ED A9 


0171 A. 0138 


CCD 




013A ED 89 


0172 




CCDB 




013C ED 


Al 


0173 




CCI 




013E ED 


Bl 


0174 




CCIH 




0140 




0175 i 








0140 2F 




0176 A, 


.0140 


CHA 




0141 




0177 i 








0141 27 




0178 A 


.014! 


DAA 




0142 




0179 i 








0142 35 




0180 A 


.0142 


DCR 


H 


0143 OD 


35 05 


0181 




OCR 


IND(X) 


0146 FD 


35 05 


0182 




DCR 


INDC!!) 


0149 3D 




0183 




OCR 


A 


014A 05 




0184 




DCR 


B 


014B OB 




0185 




OCX 


B 


014C OD 




0186 




DCR 


C 


0140 15 




0187 




DCR 


D 


OllB IB 




0188 




DCX 


D 


014F XO 




0169 




DCR 


G 


0150 25 




0190 




DCR 


U 


0151 2B 




0191 




DCX 


H 


0152 DO 


2B 


0192 




DCX 


X 


0154 FD 


2B 


0193 




DCX 


St 


0156 2D 




0194 




OCR 


L 


0157 3B 




0195 




OCX 


SP 


0158 




0196 i 








0158 F3 




0197 A. 0158 


DI 




0159 




0198 1 








0159 10 


2g 


0199 A. 0159 


OJNZ 


|4^DIS 


015B 




0200 i 








015B FB 




0201 A. 


.0158 


EI 




015C 




0202 ; 








015C E3 




0203 k. 


.015C 


XTHL 




0150 DD 


E3 


0204 




XT IX 




015r FD 


E3 


0205 




XTIlf 




0161 06 




0206 




BXAF 




0162 Efi 




0207 




XCHO 




0163 D9 




0208 




EXX 




0164 




0209 i 








0164 76 




0210 A 


.0164 


HLT 




0165 




0211 i 








0165 ED 


46 


0212 A 


.0165 


IMO 




0167 ED 


56 


0213 




IH1 




0169 ED 


5E 


0214 




IM2 




016B 




0215 i 








016b ED 


••a 


0216 A 


.016B 


IHP 


A 


016D DB 


20 


OiP 




IN 


N 


016F ED 


40 


0218 




INP 


B 


0171 ED 


4d 


0219 




INP 


C 


0173 ED 


50 


0220 




INP 


D 


0175 ED 56 


0221 




IHP 


E 


0177 ED 


60 


0222 




IHP 


II 


1179 ED 


06 


aiZi 




INP 


L 


re 




0221 : 









r-Bge 



Page U 



Addr B1 B2 Bj B*) E Line Label 



Oped Operand 



Addr 31 B2 hi Bt E Line Label 



Oped Operand 



I 

Q 



< 



00 






U3 



13 

IC 



017B 31 

017C m 
017F ro 

0182 3C 

0183 01 
0181 03 

0185 OC 

0186 11 
0187 
0188 

0189 21 
018* 23 
018B DO 
0180 FD 
018F 2C 

0190 33 
0191 

0191 ED 
0193 ED 
0195 ED 
0197 ED 
0199 
0199 E9 
019A DO 
019C FD 
019E DA 
Oim FA 
OlAl D2 
01A7 C3 
OUA C2 
01AD F2 
01B0 EA 
01B3 E2 
01B6 CA 
01B9 
01B9 
01BB 18 
013D 30 
OIBF 20 
01C1 28 
01C3 
01C3 02 
Old 12 
01C5 77 
01C6 70 
01C7 71 
01C8 72 
01C9 73 
01CA 71 
01CB 75 
OICC 36 
01CE m 
01D1 DD 
01D1 DD 
OlD' OD 
01DA DD 



31 05 
31 05 



38 



23 
23 



AA 
BA 
A2 
B2 



E9 
E9 

88 05 
88 05 
88 05 
88 05 
88 05 
88 05 
88 05 
88 05 
88 05 

2E 

2E 
2E 

2E 

2E 



20 

77 05 

70 05 

71 05 
?2 05 

a 05 



0225 A. one 

0226 
022T 
0228 
0229 
0230 
0231 
0232 
0233 
0231 
0235 
0236 
0237 
0238 
0239 
021)0 

0211 : 

0212 A. 0191 
0213 

0211 

0215 

02«6 i 

0217 A. 0199 

0218 

0249 

0250 

0251 

0252 

0253 

0251 

0256 
0257 
0258 

0259 i 

0260 A.01B9 
0261 

0262 
0263 
0261 

0265 i 

0266 A.01C3 
026' 

0268 
0269 
02T0 
0271 
02T2 
02'' 3 
02''1 
02''5 
0276 
027- 
027s 

028u 



INR 


H 


INR 


IHD(X) 


INR 


INOdf) 


INR 


A 


INR 


B 


INX 


B 


INR 


C 


INR 


D 


INX 





INR 


E 


INR 


H 


INX 


H 


INX 


X 


INX 


Y 


INR 


L 


INX 


SP 


INO 




INDR 




INI 




INIR 




PCHL 




PCIX 




PCIX 




JC 


NN 


JH 


NN 


JNC 


NN 


JMP 


NN 


JMZ 


NN 


JP 


NN 


JPE 


NN 


JPO 


NN 


JZ 


NN 


JRC 


l+DIS 


JR 


$-»DIS 


JRNC 


$*01S 


JRNZ 


$+DIS 


JRZ 


|*DIS 


STAX 


B 


STAX 


D 


HOV 


H,A 


NOV 


M.B 


MOV 


M,C 


MOV 


M,D 


MOV 


M,E 


MOV 


H,ll 


HOV 


H,L 


MVI 


H,N 


MOV 


IND(X),A 


MOV 


IND(X),B 


MOV 


1NI)(X),C' 


MOV 


lhD(X),D 


MOV 


iNi)(x),b: 



«»-■ # 



% 



01DD DD 71 


05 


0281 


HOV 


TND(X),H 


01E0 DD 75 


05 


0282 


MOV 


iND(X),L 


0ie3 DD 36 05 20 


0283 


MVI 


INO(X),N 


01E7 




0281 J 






01E7 FD 77 


05 


0265 A.01E7 


MOV 


IND(r),A 


01EA FD 70 


05 


0286 


HOV 


IND(lf),B 


01E0 FD 71 


05 


0287 


MOV 


IND(X),C 


01F0 FD 72 


05 


0288 


MOV 


INO(X),D 


01F3 FD 73 


05 


0289 


MOV 


INO(lf),E 


01F6 FD 71 


05 


0290 


MOV 


INDCY),H 


01F9 FD 75 


05 


0291 


MOV 


INB{J),L 


01FC FD 36 05 20 


0292 


MVI 


INO(lf),N 


0200 




0293 J 






0200 32 88 


05 


0291 A. 0200 


STA 


MN 


0203 ED 43 S8 05 


0295 


SBCO 


NN 


0207 ED 53 


88 05 


0296 


SDED 


NN 


020B 22 88 


05 


0297 


SHLD 


NN 


020E DD 22 


88 05 


0298 


SIXD 


NN 


0212 FD 22 


88 05 


0299 


SIXD 


NN 


0216 EB 73 88 05 


0300 


SSPD 


NN 


021 A 




0301 ! 






021A OA 




0302 A.021A 


LDAX 


B 


021B 1A 




0303 


LDAX 


D 


021C 7E 




0301 


HOV 


A,M 


021D DD 7E 05 


0305 


MOV 


A,IND(X) 


0220 FD 7E 05 


0306 


HOV 


A.IKDCX) 


0223 3A 88 05 


0307 


IDA 


NN 


0226 7F 




0308 


MOV 


A, A 


0227 78 




0309 


MOV 


A.B 


0228 79 




0310 


HOV 


A.C 


0229 7A 




0311 


NOV 


A.D 


022A 7B 




0312 


MOV 


A,E 


022B 7C 




0313 


HOV 


A.H 


022C ED 57 




0311 


IDAI 




022E 7D 




0315 


MOV 


A,L 


022F 3E 20 




0316 


MVI 


A,N 


0231 ED 5F 




0317 


LDAR 




0233 




0318 i 






0233 16 




0319 A. 0233 


MOV 


B.M 


0231 DD 16 05 


0320 


HOV 


B,IHD(X) 


0237 ro 16 


05 


0321 


MOV 


B,IND(X) 


023A 17 




0322 


mv 


B,A 


023B 10 




0323 


HOV 


B,B 


023C 11 




0321 


MOV 


B,C 


023D 12 




0325 


MOV 


B,0 


023E 13 




0326 


HOV 


B.E 


023F 11 




0327 


HOV 


B,H 


02110 15 




0328 


MOV 


B.L 


0211 06 20 




0329 


MVI 


B.N 


0213 




0330 i 






0213 ED IB 


Srt 05 


0331 A. 0213 


LBCD 


NN 


0217 01 flB 


!>!> 


0332 


LXl 


B.Nh 


02MA 




0333 i 






02IIA itE 




03311 A.02tA 


MOV 


C.M 


02MB DD IE 


05 


;1335 


MOV 


C,1ND(X) 


021E m HE 


OH 


1^336 


MOV 


C.INDCY) 



(0 

< 



m 



to 






rage 



Page a 



Addr Bl B2 B3 Bk £ Line Label 



Oped Operand 



Addr 81 B2 B3 Bl E Line Label 



Opod Operand 



I 



0251 IF 

0252 *a 

0253 19 

0251 tA 

0255 IB 

0256 1C 

0257 ID 

0258 OE 
025A 
025A 56 
025fl 00 
025E FD 

0261 57 

0262 50 

0263 51 
0261) 52 

0265 53 

0266 51 

0267 55 

0268 16 
026A 
026a ED 
026E 11 
0271 

0271 5E 

0272 00 
0275 FD 

0278 5P 

0279 58 
027 A 59 
027B 5i 
027C 5B 
027D 5C 
027E 50 
027F IE 
0281 

0281 66 

0282 DO 
0285 FO 

0288 67 

0289 60 
028A 61 
028B 62 
028C 63 

0280 M 
028E 65 
02aF 26 
0291 
0291 2A 
0291 21 
0297 
029' ED 
0299 
0299 DD 

■) DO 



20 



56 05 
56 05 



20 

SB 88 OS 
88 05 



5E 05 

5E 05 



20 



66 05 
66 05 



20 

88 05 
88 05 

2A M Ci 
21 da 05 



033'' 
0338 
0339 
0310 
0311 
0312 
0313 
0311 

0315 i 

0316 A,025A 
0317 

03IB 
0319 
0350 
0351 
0352 
0353 
0351 
0355 
0356 

0357 i 

0358 A. 026a 
0359 

0360 i 

0361 A. 0271 
0362 

0363 
O36I 
0365 
0366 

0367 
0368 
0369 
0370 
0371 

0372 i 

0373 A. 0281 
0371 

0375 

0376 

0377 

0378 

0379 

0380 

0381 

0382 

0383 

0381 i 

0385 A. 0291 

0386 

038-' i 

oj8a A.02y 

0189 i 
0.-(90 A. 0299 
0391 
039-' i 



MDV 


C,A 


HOV 


C,B 


HOV 


C.C 


HOV 


C,D 


MOV 


C.E 


MOV 


C,H 


MOV 


C,L 


MVI 


C N 


mv 


D.M 


MOV 


D.INOCX) 


MOV 


D.INDCSIJ 


MOV 


D,A 


MOV 


B.B 


W)V 


D,C 


MOW 


D,0 


mv 


D.E 


MOV 


D.H 


HOV 


0,L 


KVI 


D.N 


LOED 


NN 


LXI 


0,HH 


M3V 


E.M 


HQV 


E.INDiX) 


MOV 


E.INDCX) 


MOV 


E.A 


MOV 


E.fl 


MOV 


E.C 


HOV 


E.D 


HDV 


E.E 


MOV 


E.H 


MOV 


E,L 


MVI 


E.N 


MOV 


H.M 


MOV 


U.IND(X) 


MOV 


H.INDdO 


MOW 


li.A 


MOV 


H.B 


MOV 


H.C 


HOV 


H.D 


M3V 


H,E 


HOV 


H.H 


MOV 


H.L 


MVI 


H,N 


UltD 


HH 


LXI 


H.NN 


LDIA 




UXD 


m 


LXI 


x,m 



02A1 FD 


2A 


86 05 


0393 A.02A1 


02A5 FD 


21 


8b 05 


0391 


02A9 






0395 i 


02A9 6E 






0396 A.02A9 


02AA OD 6E 05 


0397 


02AD FD 


6E 05 


0398 


02B0 6F 






0399 


0281 68 






0100 


02B2 69 






0101 


02B3 6a 






0102 


02B1 6B 






0103 


02B5 6C 






0131 


02B6 6D 






0105 


02B7 2E 


20 




0106 


02B9 






010T J 


02B9 ED 


IF 




0108 A.02B9 


02BB 






0109 i 


02BB ED 7B 68 05 


0110 A.02BB 


02BF F9 






0111 


02C0 DD F9 




0112 


02C2 F0 F9 




0113 


02C1 31 


88 05 


0111 


02C7 






0115 i 


02C7 E0 A8 




0116 A.02C7 


02C9 ED b8 




0117 


02CB ED 


AO 




0118 


02CO ED 


BO 




0119 


02CF 






0120 i 


02CF ED 


11 




0121 A.02CF 


02D1 






0122 i 


02D1 00 






0123 A.02D1 


02D2 






0121 ; 


■02D2 b6 






0125 A.02D2 


0203 DD 66 


05 


0126 


0206 F0 


B6 


05 


0127 


02D9 B7 






0128 


02DA BO 






0129 


0206 ei 






0130 


020c B2 






0131 


02DD B3 






0132 


02DE Bl 






0133 


02DF 85 






0131 


02E0 F6 


20 




0135 


02E2 






0136 1 


02E2 ED 


BB 




0137 A.02B2 


02E4 ED 


B3 




0138 


02E6 






0139 ; 


02E6 ED 


79 




0110 A.02EO 


02E8 ED 


11 




0111 


02EA ED 


19 




0112 


02EC ED 


51 




J*,; 


n2EE EO 


59 




omi 


02F0 ED 


ul 




0•^^i 


02F2 ED 


09 




.)l-iO 


02F1 03 


20 




01 1'' 


>Fb 






0-«l5 ; 



LUD 


NN 


LXI 


X.NN 


mv 


L.M 


MOV 


L.INDCX) 


HOV 


L.INDClt) 


MOV 


L.A 


MOV 


L.B 


MOV 


L.C 


MOV 


L.O 


MOV 


L,£ 


HOV 


L.H 


HOV 


L,L 


MVI 


L.N 


LDBA 




L3PD 


m 


SPHL 




SPIX 




SPH 




LXI 


SP.NN 


LOD 




LDDR 




LDI 




LDIR 





NBQ 



MOP 



ORA 


K 


ORA 


INDCXI 


ORA 


INOCK) 


ORA 


A 


ORA 


B 


ORA 


C 


ORA 


D 


ORA 


E 


ORA 


H 


OttA 


L 


QRI 


N 


OUT0H 




OUTIH 




OOTP 


A 


OUTP 


B 


OUTP 


C 


OUTP 


D 


OUTP 


E 


OUTP 


H 


OUTP 


L 


OUT 


N 



rage 9 
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A<Ur Bl bk 63 B"i t Line Lauel 



Oped Operana 



Ch 






ca 



U1 



M 

M3 



a2f6 ED »B 




0^'49 i!.02F6 


02Fa ED A3 




O-iSO 


OZFA 




0151 i 


OZF* Ft 




0152 k.02Fk 


OZFB CI 




0U53 ■ 


02FC D1 




0151 


02KD El 




0155 


02FE DO El 




0156 


0300 FO El 




OI157 


0302 F5 




0150 


0303 C5 




0159 


0304 05 




0160 


0305 E5 




0161 


0306 DD E5 




0162 


0308 FD E5 




0163 


030* 




0161 ; 


O3OA CB 86 




0165 *.030A 


030c m CB 05 


86 


Oil 66 


0310 FD CB 05 


86 


016T 


031<( CB 87 




0168 


0316 CB 80 




0169 


0318 CB 81 




0170 


031* CB 82 




0171 


031c CB 83 




om 


03IE CB 8<i 




0173 


0320 CB 85 




0171 


0322 




0175 i 


0322 CB 8E 




0176 


0321 DD CB 05 


BE 


0177 


0328 FD CB 05 BE 


0178 


032c CB 8f 




0179 


032B CB 88 




0180 


0330 CB 89 




0181 


0332 CB fl* 




0182 


0331 CB 8B 




0183 


0336 CB Be 




0181 


0338 CB 80 




0185 


033A 




0186 i 


033/1 CB 96 




0187 


033c DO CB 05 96 


0188 


0310 FD CB 05 


96 


0189 


031*1 CB 97 




0190 


O3I6 CB 90 




0191 


03M8 CB 91 




0192 


03IA CB 92 




0193 


O311C CB 93 




0194 


03'IE CB 9't 




0195 


0350 CB 95 




019u 


0352 




C19'' ! 


0352 CB 9E 




0198 


035t DD CB 05 


9E 


0199 


0358 FD CB 05 


9E 


n5i30 


035c CE 9F 




0SI1I 


35E CB 98 




0502 


0350 CD 99 




0503 


0362 CB 9« 




050^ 



OUTD 




CUTI 




POP 


PSW 


POP 


B 


POP 


D 


fOP 


il 


POP 


X 


POP 


i 


PUSH 


PSW 


PUSH 


B 


PUSH 


D 


PUSH 


H 


PUSH 


X 


PUSH 


y 


BBS 


O.H 


RES 


• O.lNDOt) 


RES 


O.lHDiX) 


RES 


0,* 


RES 


0,B 


RES 


0,C 


RES 


0,0 


HES 


O.E 


RES 


0,H 


HES 


O.L 


RES 


l.M 


RES 


1,IHD(X) 


RES 


1,IND(Y) 


RES 


1.* 


RES 


l.B 


RES 


1,C 


RES 


1,0 


HES 


l.E 


RES 


l.H 


RES 


l.L 


RES 


2,H 


RES 


2,1ND(X) 


RES 


2,IND(1!) 


RES 


2,* 


RES 


2,B 


RES 


2,C 


RES 


2,0 


RES 


2,E 


RES 


2,H 


RES 


2,L 


RES 


3,H 


HES 


3,IHIMX1 


fits 


3,IND(V* 


ms 


3.il 


HES 


3,B 


BES 


3,C 


RES 


3,D 



I 



Addr Bl B2 E3 


a-i 1 


E : Ine Label 


0361 CB 9B 




Ci05 


0366 CB 9C 




0506 


0368 CB 9D 




0507 


O36A 




0508 ; 


036a CB A6 




0509 


036€ DD CB 05 


A6 


0510 


0370 FD CB 05 


Ab 


0511 


0371 CB A7 




0512 


0376 CB AO 




0513 


0378 CB Al 




0511 


037A CB kZ 




0515 


037C CB A3 




0516 


037E CB Al 




0517 


0380 CD A5 




0518 


0382 




0519 i 


0382 CB AE 




0520 


0381 DD CB 05 AE 


0521 


0388 FD CB 05 AE 


0522 


038c CB AF 




0523 


O38E CB A8 




0521 


0390 CB *9 




0525 


0392 CB AA 




0526 


0391 CB AB 




0527 


0396 CB AC 




0528 


0398 CB AO 




0529 


039A 




0530 i 


039A CB B6 




0531 


039c OD CB 05 B6 


0532 


03A0 FD CB 05 


B6 


0533 


OSfttt CB B7 




0531 


03A6 CB BO 




0535 


03A8 CB Bl 




0536 


03AA CB B2 




0537 


03AC CB B3 




0538 


03AE CB Bl 




0539 


03B0 CB B5 




0510 


03B2 




0511 J 


03B2 CB BE 




0512 


03B1 DD CB 05 


BE 


0513 


03B8 FD CB 05 BE 


0511 


03BC CB BF 




0515 


03BE CB BB 




0516 


03C0 CB B9 




0517 


03C2 CB BA 




0518 


03C1 CB BB 




0519 


03C6 CB BC 




0550 


03C8 CB BD 




0551 


03CA 




0552 i 


03CA C9 




0553 A. 03c 


OiCB Dfl 




05?1 


ascc Fd 




0555 


n3CD 00 




0550 


03CE CO 




OSb"" 


03CF FO 




iV-is 


3D0 Ed 




0:^59 


03D1 EO 




05oO 



Oped Operand 



RES 


3,E 


RES 


3.H 


RES 


3,L 


RES 


1,H 


RES 


1,IND(X) 


RES 


1,IND(K) 


RES 


1.A 


RES 


l.B 


HES 


1.C 


RES 


1,D 


RES 


l.E 


RES 


1,H 


RES 


I.L 


RES 


5,H 


RES 


5.IND(I) 


RES 


5.IHD(1f) 


RES 


5, A 


RES 


5,B 


RBS 


5,C 


HES 


5.0 


RES 


5.E 


RES 


5.H 


HES 


5.L 


RES 


6,M 


RES 


6,IND(X) 


RES 


6,IND(I) 


RES 


6,A 


RES 


6,B 


RES 


6,C 


RES 


6,0 


RES 


6,E 


RES 


6,H 


RES 


6,L 


RES 


7,M 


RES 


7,IN0(X) 


RES 


7,1ND(Y) 


RES 


7, A 


RES 


7,B 


RES 


7.C 


RES 


7,D 


RES 


7.E 


RES 


7.H 


RES 


7,L 


BET 




HC 




RH 




HHC 




RNZ 




HP 




RPE 




HPO 





ragti 11 



Page 12 



< 



CD 



U1 






*ddr Bl 62 63 m E Line Label 



I 

U 



03D2 ca 
0303 

03D3 EO 
03D5 EO 
0307 
0307 CB 
0309 DD 
03DD FD 
03E1 CB 
03E3 C9 
03E5 CB 
03E7 CB 
03E9 CB 
03EB CB 
03ED CB 
03EF 
03EF 17 

oaro 

03F0 CB 
03F2 DD 
03F6 FD 
03FA CB 
03FC CD 
03FE CB 
0400 CB 
01)02 CB 
0«0l) CB 
0406 CB 
0>IOB 

0408 07 
0409 

0409 ED 
040B 
040B CB 
0400 DD 
0411 FD 
0415 CB 
0417 CB 
0419 CB 
041B CB 
041D CB 
04 IF CB 
0421 CB 
0423 
0423 
0424 
0424 CB 
0426 00 
U42A fa 
042E CB 
0430 CB 
0432 CB 
0434 CB 
0436 CB 
0- 'H 



n- 



4D 
45 

16 

CB 05 16 

CB 05 16 

17 

10 

tl 

12 

13 

14 

15 



06 

CB 05 06 

CB 05 06 

07 

00 

01 

02 

03 

04 

05 



6F 

IE 

CB 05 IB 

CB 05 IE 

IF 

18 

19 

U 

IB 

1C 

ID 



oe 

CB 05 OE 

CB 05 OE 
OF 

08 

09 
OA 
OB 
OC 

OD 



0561 

0562 i 

0563 A 
0564 

0565 i 

0566 A, 
0567 
0568 
0569 
0570 
0571 
0572 
0573 
0574 
0575 

0576 J 

0577 A, 

0578 J 

0579 A, 
0580 
0581 
0582 
0583 
0584 
0585 
05S6 
0587 
0588 

0589 i 

0590 A. 

0591 i 

0592 A, 

0593 i 

0594 A. 
0595 
0596 

059'' 
0598 
0599 
0600 
0601 
0602 
0603 

0604 i 

0605 A, 

0606 ; 

0607 A, 
Oboa 

0609 
0010 
Ooll 
OoM 

0613 
06:4 

0615 
061c 



0303 
03D7 



03EF 
03FO 



0408 
0409 
040B 



0423 
0424 



fiZ 




R£TI 




HBTM 




RAiB 


H 


HALR 


INDCX) 


RALR 


I«D(K) 


RAL8 


A 


HALR 


B 


RALR 


C 


HALR 


D 


RALR 


E 


RALR 


H 


RALR 


L 


BAt 




RLCR 


H 


RLCR 


IND(X) 


BLCB 


INO(K) 


RLCR 


A 


RLCR 


B 


RLCR 


C 


RLCB 


D 


RLCR 


E 


RLCB 


H 


RLCR 


L • 



Addr Bl B2 63 b* E Line Label 



Oped Operand 



RLC 



RLD 



RARR 


H 


RARR 


IND(X) 


RARR 


IND(X) 


RARR 


A 


RARR 


B 


RARR 


C 


BABR 


D 


RARR 


E 


RARR 


H 


RARR 


L 


RAR 




8BCR 


H 


RRCH 


ISD(X) 


RRCR 


INO(X) 


HRCR 


A 


RRCH 


B 


HKCH 


C 


HRCR 


D 


HRCR 


B 


HHCR 


a 


HHCR 


L 



043C 


0617 i 








043C OF 


0618 A 


043C 


RRC 




043D 


0619 ; 








043D ED bl 


0620 A 


04 3P 


RRO 




04 3F 


0621 i 








043F C7 


0622 A.043F 


RSt 





0440 CF 


0623 




HST 


1 


0441 07 


0624 




RST 


2 


0442 DF 


0625 




RST 


3 


0443 E7 


0626 




RST 


4 


0444 EF 


0627 




RST 


5 


0445 F7 


0628 




HST 


6 


0446 FF 


0629 




RST 


7 


0447 


0630 i 








0447 9E 


0631 * 


.0447 


SBB 


M 


044B OD 9E 05 


0632 




SBB 


IND{X) 


044B FD 9E 05 


0633 




SBB 


IMDCX) 


n44E 9F 


0634 




SBB 


A 


044F 98 


0635 




SBB 


B 


0450 99 


0636 




SBB 


C 


0451 9A 


0637 




SBB 


D 


0452 9B 


063S 




SBB 


S 


0453 9C 


0639 




SBB 


H 


0454 90 


0640 




SBB 


L 


0455 DE 20 


0641 




SBI 


H 


0457 


0642 i 








0457 EO 42 


0643 A.0457 


OSBC 


B 


0459 ED 52 


0644 




DSBC 





045B ED 62 


0645 




DSBC 


H 


0451) ED 72 


0646 




DSBC 


SP 


045F 


0647 i 








045F 37 


0648 A 


.045F 


STC 




0460 


0649 } 








0460 CB C6 


0650 A. 0460 


SET 


O.H 


0462 DD CB 05 C6 


0651 




SET 


0,IMD(X) 


0466 FD CB 05 C6 


0652 




SET 


O.INDOe) 


046 A CB C7 


0653 




SET 


O.A 


046c CB CO 


0654 




SET 


O.B 


046E CB CI 


0655 




SET 


0,C 


0470 CB C2 


0656 




SET 


O.D 


0472 CB C3 


0657 




SET 


O.E 


0474 CB C4 


0658 




SET 


0,H 


0476 CB C5 


0659 




SET 


O.L 


0478 


0660 ; 








0478 CB CE 


0661 




SET 


l.H 


047A DD CB 05 CE 


0662 




SET 


I.IWDCX) 


047E FD CB 05 CE 


0663 




SET 


1,IND(X) 


0482 CB CF 


0664 




SET 


1,A 


0484 CB ca 


0665 




SET 


l.B 


0486 CB C9 


0o66 




SET 


1,C 


0488 ca CA 


066'' 




SET 


1.D 


048A CB CB 


Obbd 




SET 


l.E 


048C CB CC 


Oot)9 




SET 


l.H 


04dE CB CD 


ilCO 




SET 


1,L 


0490 


0o71 i 








0490 CB Db 


Oto-^a 




SE1 


2.M 



("age rj 



Page It 



Addr B1 D2 B3 BM E Line Label 



Opod Operand 



Addr 81 B2 E3 EM E Line Label 



Oped Operand 



I 



< 



00 



U1 



-J 



092 DD 


CB 


05 


D6 


0673 


01)96 FD 


CB 


05 


D6 


067M 


0M9A CB 


D7 






0675 


0190 CB 


DO 






0676 


019E CB 


D1 






0677 


OilAO CB 


D2 






0'>''d 


011A2 CB 


D3 






0679 


OlfAM CB 


DM 






0680 


0MA6 CB 


D5 






f j8l 


CIAS 








0682 


01IA8 CB 


DE 






0683 


OIAA DD 


CB 05 


DE 


068M 


OMAE FD 


CB 


05 


DE 


0685 


0MB2 CB 


DF 






0686 


OMBI CB 


D8 






0687 


0l)B6 CB 


D9 






0688 


04B8 CB 


DA 






0689 


01BA CB 


DB 






0690 


OtBC CB 


DC 






0691 


OMBE CB 


DD 






0692 


04C0 








0693 


MCO CB 


E6 






069M 


0IIC2 DD 


CB 


05 


e6 


0695 


01IC6 FD 


CB 05 E6 


0696 


04CA CB 


E7 






0697 


OMCC CB 


EO 






0698 


OCE CB 


El 






0699 


0>4DO CB 


E2 






0700 


0I(D2 CB 


E3 






0701 


OMDM CB 


EM 






0702 


OHDb CB 


E5 






0703 


0<tD8 








070M 


0IID8 CB 


EE 






0705 


0>4DA DD 


CB 


05 


EE 


0706 


OIDE FD 


CB 


05 


EE 


0707 


0ME2 CB 


EF 






0708 


MEM CB 


E8 






0709 


0ME6 CB 


E9 






0710 


04E8 CB 


EA 






0711 


OMEA CB 


EB 






0712 


OlIEC CB 


EC 






0713 


OMEE CB 


ED 






071M 


OMFO 








0715 


OMFO CB 


F6 






0716 


0MF2 DD 


CB 05 


F6 


0717 


0MF6 FD 


CB 


05 


F6 


0718 


OMFA CB 


F7 






0719 


OMFC CB 


FO 






0720 


OMFE CB 


F1 






0721 


0500 CB 


F2 






0722 


0502 CB 


F3 






0723 


050M CB 


FM 






072M 


OSOb CU F5 






0-'25 


0506 








0723 


Ob08 CB 


FE 






0727 


05I)A DD 


CB 


05 


FE 


0-'28 



SET 


2,IND(X) 


SET 


2,IND(Y) 


SET 


2. A 


SET 


2.B 


SET 


2,C 


SET 


2,0 


SET 


2,E 


SET 


2,H 


SET 


2,L 


SET 


3,M 


SET 


3,IND(X) 


SET 


3,IND(Y) 


SET 


3, A 


SET 


3.B 


SET 


3,C 


SET 


3,D 


SET 


3.E 


SET 


3.H 


SET 


3.L 


SET 


M.M 


SET 


M,IND(X) 


SET 


M,IND(Y) 


SET 


M.A 


SET 


M.B 


SET 


M.C 


SET 


M.D 


SET 


M.E 


SET 


M.H 


SET 


M.L 


SET 


5.M 


SET 


5,IND(X) 


SET 


5,IND(Y) 


SET 


5. A 


SET 


5.B 


SET 


5.C 


SET 


5,D 


SET 


5.E 


SET 


5,11 


SET 


5,L 


SET 


6.M 


SET 


6,IND(X) 


SET 


6,IND(Y) 


SET 


6, A 


SET 


6.B 


SET 


6,C 


SET 


6,D 


SET 


6,E 


SET 


b.H 


SET 


6,L 


SET 


7,M 


SET 


7,lND()i> 



050E FD 


CB 


05 FE 


0729 


0512 CB 


Fr 




07 jO 


051M CB 


F8 




0731 


0516 CD 


F9 




0-'32 


0518 CB 


FA 




0733 


051A CB 


FB 




073M 


051C CB 


FC 




0735 


051E CB 


FD 




0736 


0520 






0737 ; 


0520 CB 


26 




0738 A. 0520 


0522 DD 


CB 05 26 


0739 


0526 FD CB 05 26 


07 MO 


052A CB 


27 




071(1 


052C CD 


20 




07M2 


052E CB 


21 




07M3 


0530 CB 


22 




07MM 


0532 CB 23 




07M5 


053M CB 2M 




07M6 


0536 CB 25 




07M7 


0538 






07M8 ; 


0538 CB 2E 




07M9 A. 0538 


053A DD 


CB 


05 2E 


0750 


05 3£ FD 


CB 


05 2E 


0751 


0512 CB 2F 




0752 


05MM CB 


28 




0753 


05M6 CB 


29 




075M 


05M8 CB 2A 




0755 


05MA CB 


2B 




0756 


05MC CB 


2C 




0757 


05ME CB 


2D 




0758 


0550 






0759 ! 


0550 CB 


3E 




0760 A. 0550 


0552 DD 


CB 


05 3E 


0761 


0556 FD 


CB 


05 3E 


0762 


055A CB 


3F 




0763 


055C CB 


38 




076M 


055E CB 


39 




0765 


0560 CB 


3A 




0766 


0562 CB 


3B 




0767 


056M CB 


3C 




0768 


0566 CB 


3D 




0769 


0568 






0770 i 


0568 96 






0771 A.056B 


0569 DD 


96 


05 


0772 


056C FD 


96 


05 


0773 


056F 97 






0-'7l) 


0570 90 






0775 


0571 91 






0-'76 


0572 92 






0-'77 


05''3 93 






0''78 


057l( 911 






0-»-»9 


OS'S 95 






o-'oo 


05''6 D6 


20 




O-'dl 


05"8 






0-ii ; 


0578 AE 






fl''d3 A. 0578 


05-'9 DD 


AE 


05 


O-'dM 



SET 


7,IND(Y) 


SET 


•'.A 


SET 


■'.B 


SET 


7,C 


SET 


7,D 


SET 


■'.E 


SET 


7,H 


SET 


7,L 


SLAR 


M 


SLAB 


IND(X) 


SLAR 


IND(Y) 


SLAR 


A 


SLAR 


B 


SLAR 


C 


SLAR 


D 


SLAR 


E 


SLAR 


H 


SLAR 


L 


SRAR 


M 


SRAR 


IND(X) 


SRAR 


IND(Y) 


SHAR 


A 


SRAR 


B 


SRAR 


C 


SRAR 


D 


SRAR 


E 


SRAR 


H 


SRAR 


L 


SRLR 


M 


SRLR 


IND(X) 


SRLR 


IND(Y) 


SRLR 


A 


SRLR 


B 


SRLR 


C 


SRLR 


D 


SRLR 


E 


SRLR 


H 


SRLR 


L 


SUB 


M 


SUB 


IND(X) 


SUB 


IND(Y) 


SUB 


A 


SUB 


B 


SUB 


C 


SUB 


D 


SUB 


E 


SUB 


H 


SUB 


I 


SUI 


N 


XHA 


M 


XRA 


INDU) 



Addr B1 B2 B3 B4 E Line Label Oped Oparand 

05TC FD AE 05 0785 MA IND{Y) 

057F AF 0786 XHA A 

0580 a8 0787 XHA B 

0581 A9 0788 XHA C 

0582 AA 0789 XHA D 

0583 AS 0790 XHA S 

0584 AC 0791 XHA H 

0585 AB 0792 XHA L 

0586 EE 20 0793 XHI N 
0588 079* ; 

0588 0795 ; Now for the definitions 

0588 0796 ; 

0588 0020 5 0797 M S3U 20H 

0588 00 00 0798 NH DW 

058A 0005 s 0799 IHD EQU 5 

058a 0030 = 0800 DIS EQU 30H 

058a 0801 ; 

058a 0802 A. 058a END 
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4.6 SYWSAVE UTILITY 

The SYMSAVE utility is an applications program that may be used to create 
an equate batch from a symbol table left in memory irnmediately after an 
assembly. This equate batch is stored as an editor source file -and can 
be edited by the line editor and assembled by the assembler. The program 
is invoked from the MDOS executive by typing SYMSAVE followed by an ASCII 
filename parameter enclosed in double quotes and an optional ASCII mask 
string enclosed in double quotes. 

[unit:]SYMSAVE "<filename>" ["<mask string>"] 

The mask string can be up to ten characters long. It is used to save only 
those symbols in the symbol table that start with the specified mask string. 



Example: 

ADDR B1 B2 B3 E LINE LABEL 



OPCODE OPERAND 



0000 




1000 


ORG 


4000H 


4000 


C3 00 40 


2000 START 


J HP 


$ 


4003 


01 


3000 DATAl 


DB 


01 


4004 


02 


4000 DATA2 


DB 


02 


4005 


03 


5000 DAT A3 


DB 


03 


4006 




6000 FINISH 


END 


START 



Immediately after the above proqram is assembled, the symbol table is still 
resident in memory. To create a disk file of symbols from the above assembly 
type: 

SYMSAVE "TEST" 

The file TEST that SYHSAVE creates is an editor compatible source file 
which looks as follows: 



0001 


START 


EQU 


4000H 


0002 


DATAl 


EQU 


4003H 


0003 


DATA2 


EQU 


4004H 


0004 


DATA3 


EQU 


4005H 


0005 


FINISH 


EQU 


4006H 



If only the data symbols were required, the mask string parameter can be 
used as follows: 

SYMSAVE "TEST!" "DATA" 

The file TESTl looks as follows: 



0001 


DATAl 


EQU 


4003H 


0002 


DATA2 


EQU 


4004H 


0003 


DATA3 


EQU 


4005H 



This file contains only the symbols which start with the string DATA. 
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A symbol equate file can be used in other programs by using the assembler 
LINK pseudo-op. 

Example: 



ADDR 


Bl 82 B3 


E LINE LABEL 


'OPCODE 


OPERAND 


0000 




1000 


LINK 


'TEST' 


0000 




2000 


ORS 


FINISH 


4006 


3E 01 


3000 BEGIN 


MVI 


A.DATAl 


4008 


32 03 40 


4000 


STA 


DATA2 


400B 


C3 m 40 


5000 


JMP 


START 


400E 




6000 


END 


BEGIN 



By Unking the equate batch file with the new program segment all of the 
symbols defined in the first program segment can be referenced in the new 
program segment. 

4.7 FILECOPY UTILITY 

The FILECOPY utility is an applications program that allows files to be 
copied from one disk to another or onto the sane disk under a different 
filename. To improve speed in the process of copying a file, it uses 
all available memory after the end of the program as a buffer. To invoke 
the program from the HDOS executive type FILECOPY followed by a filename 
enclosed in double quotes and an optional newfilename enclosed In double 
quotes or a unit number by itself if the copied file is to have the same 
name as the original . 

Cunit:]FILECOPY "<Cunit:]filename>" "<Cun1t:]newfilename>" 

or 

[unit:]FILECOPY "<Cunit:]f11ename>" <un1t number> 

FILECOPY exits to the MOOS executive when it is done or if it encounters 
an error condition. The copied file has the same filetype as the original. 
Any file can be copied regardless of type or origin. This includes BASIC 
data and program files. Attempting to copy a file onto the same disk 
without specifying a newfilename results in a DUPLICATE NAME error. 

4.3 DISKCOPY UTILITY 

DISKCOPY is a special overlay utility that writes an absolute binary copy 
of one disk onto another. The utility overlays MDOS or BASIC. It uses 
all available manory during the copying process. The more memory in a 
system the faster the copying process. On average it takes about tvio 
minutes to copy and verify all 315k bytes of a M3D II disk. To invoke the 
utility from the MDOS executive, type: 

DISKCOPY 

A sign-on message is output: 

MICROPOLIS DISKCOPY VS X.X - COPYRIGHT 1978 
SPECIFY UNIT I FOR ORIGINAL (SOURCE) DISKETTE 
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DISKCOPY waits until the unit number 1s entered. When a number between 
and 3 is entered it prompts: 

SPECIFY UNIT # FOR DESTINATION DISKETTE 

7 

and waits until viie unit number (0 to 3) is entered. It then prompts: 

PUT DISKETTES IN SPECIFIED UNITS 

TYPE Y WHEN READY 

? 

and waits for a Y. A note of CAUTION, we strongly recormiend placing a 
write protect tab on the original (source) diskette. It is possible to 
put the wrong diskette in the wrong drive or type the wrong unit numbers. 
If your original does not have a write protect tab and you make an error, 
the original can be overwritten. The write protect tab provides a physical 
interlock which disables the write electronics. 

When a Y is typed DISKCOPY will start the copying process. During copying, 
the process can be temporarily halted between read source and write 
destination cycles by typing a control S. The process is restarted by typing 
any other key except a control C. 

The control C will cancel the entry or copy process and prompt: 

CANCELLED 
MORE ? 

If a Y 1s typed DISKCOPY starts from the top asking for the unit numbers 
again. If an N 1s typed DISKCOPY prompts: 

PUT SYSTEM DISKETTE IN UNIT 
TYPE Y WHEN READY 



When a Y is typed the disk in unit 1s rebooted. If it's an MODS diskette 
MOOS is booted. If the disk in unit is a BASIC only disk or some other 
bootable system, 1t will be booted in and sign on. DISKCOPY is overlayed 
by the incoming system and is no longer in memory. 

When the disk has been copied and verified correctly DISKCOPY outputs: 

GOOD COPY 
MORE ? 

If the copy cannot be completed or does not verify correctly DISKCOPY outputs: 

PERM I/O ERROR ON DESTINATION DISKETTE 

or 

PERM I/O ERROR ON SOURCE DISKETTE 

indicating where the error occurred. 
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It IS possible for single drive systems to make use of the DISKCOPY utility 
to copy from one disk to another. In this case it is imperative that the 
original diskette be write protected with a write protect tab. The procedure 
involves specifying the same unit number for both source and destination 
disks. Immediately after typing a Y in response to the TYPE Y WHEN READY 
prompt, type a control S. The DISKCOPY program will read as many tracks 
from the source disk as can be contained in main memory and then pause. 
When the select indicator light goes out, remove the source diskette and 
insert the destination diskette. Press the return key and as soon as the 
select indicator light comes on type a control S again. When the select 
indicator light goes out again, the data from the source disk has been 
written to the destination disk and one complete cycle is finished. This 
process is repeated, swaping the source and destination disks in and out 
until the entire disk is copied. After the last data 1s written onto the 
destination disk, the program goes directly into a verifying process and 
win not pause until this is over. When the source is placed back into the 
drive and the return key is pressed the system will prompt: GOOD COPY or 
output an error message as discussed above. At this point the copy is 
complete. 

4.9 ERROR MESSAGES 

This section is a suiima ry of the error messages generated by the MDOS 
shared subroutines. The shared subroutines return an error code in the 
A register when an error exit occurs. These codes can be passed to the 
error message output routines to generate the proper error message. 

Example: 

A file is created by the following BASIC program: 

10 DIM A$(24a) 

20 Z$=CHAR$(13):REM CARRIAGE RET 

30 OPEN 1 "N:TEXTFILE":REM NEW FILE 

40 INPUT A$:REH GET A LINE OF TEXT FROM CONSOLE 

50 IF A$="EXIT" THEN 80:REM END INPUT BY TYPING EXIT 

60 PUT 1 A$+Z$:REM CONCATENATE CARR RTN AT END 

70 GOTO 40: REM LOOP TILL EXIT 

80 CLOSE 1 

90 END 

This BASIC program writes one text line per record. Each line is 
terminated with a carriage return. 

The file can be read by the following assembly language routine. Assume 
it has been assembled and given the name READ and an executable file type 
of 15. Typing READ "TEXTFILE" loads and executes the program. 
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0000 


LINK 


'SYSQ1' 


•,MDOS EQUATE BATCH 


0010 


LINK 


'SYSq2' 


iMDOS EQUATE BATCH 


0020 


ORG 


IPAPROGRAM 


;APPLICATIONS AREA 


0030 START 


CALL 


§CCRLF 


-.CARRIAGE RETURN LINEFEED 


0040 


LDA 


@NASCPAR 


;NUMBER OF ASCII PARAMETERS 


0050 


ORA 


A 


;IF ZERO 


0060 


JZ 


(BERRORMES 


; ERROR 


0070 


MVI 


C,0 


;(3ASCBUFF0 


0080 


CALL 


@TRANSFILENAME 


;MOVE INTO iASCIIBUFFER 


0090 


HVI 


B,0 


•,FILE NUMBER 


0100 


LDA 


@DRIVEN0 


■,UNIT NUMBER 


0110 


MOV 


C,A 


UNTO C FOR OPEN 


0120 


LXI 


H,@FILEBUFFER0 


;USE SYSTEM BUFFER 


0130 


CALL 


iOPENFILE 


;OPEN THE FILE 


0140 


JC 


IDISKERROR 


•,IF ERROR CODE IN A 


0150 


CALL 


@RFILEINF 


-.CHECK THE FILE TYPE 


0160 


JC 


iDISKERROR 


;IF ERROR CODE IN A 


0170 


MOV 


A,B 


;FILE TYPE 


0130 


AN I 


0FCH 


;TYPE NOT ATTRIBUTES 


0190 


ORA 


A 


-.BASIC DATA FILES=0 


0200 


MVI 


A. 17 


;WRONG FILE TYPE MESSAGE 


0210 


JNZ 


iDISKERROR 


•.ERROR 


0220 NEXTCHR 


MVI 


BJ 


;FILE NUMBER 


0230 


CALL 


§RFINXPOSI 


;READ FILE BYTE AT A TIME 


0240 


JC 


EXIT 


-.END? OR ERROR? 


0250 


MOV 


B,C 


; CHARACTER FOR OUTPUT 


0260 


MOV 


A,B 


;INTO A FOR COMPARE 


0270 


CPI 


0DH 


^CARRIAGE RET END OF LINE 


0280 


CZ.. ' 


9CCRLF 


;IF CR DO CR LF 


0290 


CALL 


@COUT 


;OTHER CHR JUST OUTPUT 


0300 


J MP 


NEXTCHR 


iLOOP TILL END-FILE 


0310 EXIT 


CPI 


2 


;END-FILE? 


0320 


JZ 


I3CL0SEFILE 


; CLOSE AND RETURN TO MDOS 


0330 


STC 




; ERROR 


0340 


JMP 


iDISKERROR 


; ERROR MESSAGE IN A 


0350 


END 


START 





Note the handling of the errors in lines 60, 140, 160, 210, 240, and 

310-340. 
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The error codes are summarized below. See appendix for definitions of 
the error messages. 



CODE# 


MESSAGE 





SYNTAX ERROR 


1 


PERM I/O ERR 


2 


ENO-FILE 


3 


DISK FULL 


4 


FILE NOT FOUND 


5 


DUPLICATE NAME 


6 


PARM ERR 


7 


DRIVE NOT UP 


8 


PERM FILE 


9 


WRITE PROTECT 


10 


FILE NOT OPEN 


n 


COMMAND NOT FOUND 


12 


BAD FILE # 


13 


FILE OPEN 


14 


READ ONLY FILE 


15 


BAD RECORD # 


16 


CANCELLED 


17 


WRONG FILE TYPE 


18 


INDEX PAST EOR 


19 


LOAD ADDRESS ERROR 



--«£J9 
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4.10 COPYFILE UTILITY 

The COPYFILE utility is an applications program that allows files to be 
copied from one disk to another on a system with only one disk drive. 
The utility uses all the available memory after the end of the COPYFILE 
program as a buffer. To invoke the program from MDOS type COPYFILE 
followed by a filename: 

[unit:] COPYFILE "<[unit:] filename>" 

The COPYFILE program signs on: 

INSERT SOURCE DISKETTE INTO DRIVE 
ARE YOU READY? 

The system waits for a capital Y to be typed. Any other input is ignored 
except a control C which returns control to MDOS. When a Y is typed the 
COPYFILE program loads as much of the source file into memory as it can 
and then prompts: 

INSERT DESTINATION DISKETTE INTO DRIVE 
ARE YOU READY? 

Take the source diskette out of your drive and put the destination diskette 
into the drive. When ready type a capital Y. Any other input is ignored 
except a control C which returns control to MDOS. The COPYFILE program 
creates a file on the destination disk with the same name and filetype as 
the source file. It then writes the file from memory onto the destination 
diskette. 

If the files is longer than can be held in memory at one time the COPYFILE 
oroaram will oromot: 



program will prompt: 



INSERT SOURCE DISKETTE INTO DRIVE 
ARE YOU READY? 



The same procedure as above must be repeated until the whole file has been 
copied. When the copy is complete the OTPYFILE program returns to MDOS 
which prompts: 



If the COPYFILE program encounters any errors it displays the proper error 
message and returns to MDOS. 

COPYFILE can copy any type or length file. This includes BASIC data and 
program files. 
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4.n DEBUG - THE PDS 8080/8085 PROGRAM DEBUGGER 

MicropoHs DEBUG is a utility program which facilitates checkout and 
debugging of 8lZ58d/8085 machine language programs. It provides an 
environment in which the performance of a program can be monitored by 
starting and stopping (program execution at user-specified points and by 
examining and/or changing the contents of relevant machine registers and 

memory locations. DEBUG cannot, be used with non-808 Z80 code. 

DEBUG and the program to be monitored must co-reside in the nain system 
memory. Before DEBUG can be used an executable version must be obtained that 
uses a 4k block of memory which does not conflict with the program to be 
debugged. The process of creating an executable version of DEBUS configured 
for a specific memory space is described in Section 4.12. 

DEBUG is invoked from the MOOS executive by typing the natm of a configured 
DEBUG-XX version as created by the DEBU6-6EN utility {see Section 4.12). 
Example: 

>DEBUG-70 

MICROPOLIS DEBUG VS. X.X - COPYRIGHT 1978 

DEBUG signs on and displays an asterisk (*) which is the DEBUG Executive 
prompt. Program execution control and machine state examination and 
modification are performed by entering appropriate commands to the DEBUG 
Executive. 

The program may be executed one instruction at a time (referred to as 
"single-stepping") with the machine state displayed after each step. 
Alternatively, the results of a program segment may be examined by placing 
a breakpoint at the end of the segment. When execution of the program 
is started, it will execute in real time until the breakpoint is reached. 
Control of the computer is then returned to the DEBUG Executive and the 
user may examine the contents of memory and the machine registers. 

4.11.1 THE DEBUG EXECUTIVE 

Operation of DEBUG facilities is control ed by the DEBUG Executive. The 
executive prompts the user for a command with the character '*'. 

Executive statements are entered by typing characters in sequence on the 
console keyboard. An executive statenent is terminated by pressing the 
RETURN key. During the entry of a statement each character that is typed 
is echoed by the executive on the console display. Two control features 
may be used when entering a line. 

1) When DEL or BACKSPA'CE is pressed the next previously typed 
character will be deleted from the line. A backarrow is echoed 
to the terminal display for each character deleted. 
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2) Holding down the control key and typing X (CMTL/X) will cause 
all of the current line to be cancelled. A carriage return line 
feed combination is echoed to the terminal display. The executive 
is positioned to accept entry of a new line. 

An executive statement has the following form: 

NAME [<hex> <hex>. . .<hex>] 

The NAME in an executive statement is the name of one of the DEBUG commands. 
Command names are uppercase only and must not be preceded by any spaces. 
If the command name is not recognized by .DEBUG a SYNTAX error message is 
displayed. 

Executive statements consist of a NAME followed by up to four numeric 
parameters. There must be at least one space between the NAME and any 
parameters. All parameters must be separated from each other by at least 
one space. Entry of an executive statement with too many parameters or 
without the required spaces between fields will result in a SYNTAX error. 

Numeric parameters In executive statements are unsigned hexadecimal values 
from to FFFF. They represent such elements as memory addresses and 
register values. Entry of a numeric parameter with a value greater than 
FFFF or with illegal characters will result in a SYNTAX error. 

4.11.2 DEBUG MEMORY RELATED COMMANDS 

The DEBUG memory related conroands are similar to those available under the 
MDOS executive (see Section 4.1) with the exeception of the LIST command 
which is unique to the DEBUG context. The syntax of these conwands is 
illustrated with the aid of the following notation: 

C ] Option brackets. Pj\y parameters enclosed between brackets are 
optional . 

< > Symbol brackets. This space should be replaced by the item described. 

4.11.2.1 THE DUMP COMMAND 

DUMP <start addr.> [<end addr.>] 

The DUMP command outputs a formatted hex display of the contents of a block 
of memory. Sequential memory locations are shown 16 to a line with the meirory 
address at the left margin. If the <end addr.> is not entered only one byte 
is displayed. Example: 

* DUMP 5000 501 1 

5000 50 C0 27 77 4F 33 4F CD 7D 9E 98 00 5A FD 82 90 
5010 77 23 

Notice that memory bytes are printed out in groups of four so that addresses 
inside the line may be n»re easily computed. The grouping follows the address. 

*DUMP 5002 501 F 

5002 27 77 4F 33 4F CD 7D 9E 98 00 6A FD 82 90 
5010 77 2B 54 56 F4 3E 23 2A 34 87 19 3D 21 2C 2A 2B 
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4.11.2.2 THE ENTR COMMAND 

ENTR <start addr.> 

The ENTR comnand allows data to be entered into memory directly from the 
console device. Example: 

*£NTR 7000 
*78 89 
6F/ 

Three bytes were entered starting at location 7000 hex. These were 78 
at 7000, 89 at 7001, and 6F at location 7002. 

Typing 1n an ENTR command places the executive in a special enter rode. 
While in the enter mode each line of values that 1s typed is entered into 
menwry when the RETURN key is pressed. Until the RETURN key is pressed 
the standard backspacing and CNTL/X tools are available for line correction. 
The last value on the last line must be followed by a slash (/) to properly 
terminate the enter mode. Entry of a illegal hex value in any line will 
also cause termination of the enter rrode with the message SYNTAX ERROR. 

4.11.2.3 THE FILL COMMAND 

FILL <start addr.> <end addr.> <byte> 

The FILL comnand fills a block of memry with a specified byte. 
Example: 

* FILL 7000 8000 9 

Each byte of uremory in the block from 7000 to 8000 is changed to a 09 
by this coimand. 

4.11.2.4 THE MOVE COWAND 

MOVE <source addr.' start> <source addr. end> <dest. addr. start> 

The MOVE comnand copies the source block of memory to the destination 
block. The source block is not changed. The destination block is 
changed to be an exact copy of the source block. Example: 

* MOVE 3000 4000 7000 

Each byte in the memory block from 3000 to 4000 is copied into the 
corresponding position in the memory block from 7000 to 8000. 
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4.11.2.5 THE SEAR COMMAND 

SEAR <start addr.> <end addr.> <byte> 

The SEAR command searches a block of memory for all occurrences of the 
specified byte and displays all locations with a match. Example: 

* SEAR 3000 3020 9F 
3004 9F 

3018 9F 

The block of memory from 3000 to 3020 is searched for all occurrences of 
a 9F. Location 3004 and location 3018 both contain 9F. No other 
locations In the block contain 9F. 

4.11.2.6 THE SEARN COMMAND 

SEARN <start addr.> <end addr.> <byte> 

The SEARN command searches a block of memory for all non-occurrences of a 
specified byte and displays all locations that do not match. Example: 

* SEARN 3000 3010 67 
3002 09 67 

3006 76 67 

The block of memory from 3000 to 3010 is searched for all non-matches 
with the mask 67. Location 3002 contained a 9 rather than a 67, and 
3006 contained a 76 rather than a 67. 

4.11.2.7 THE COMP COMMAND 

COMP <start addr. block1> <end addr. block! > <start addr. block2> 

The COMP comnand compares two blocks of marory and displays address locations 
that do not compare and the data at those locations. Example: 

*COf^ 5000 500F 5010 
5004 01 09 5014 

The block of memory from 5000 to 500F is compared with the block of memory 
from 5010 to 501 F. One location fails to compare. Location 5004 contains 
01 while the corresponding location, 5014, in the second block contains 09. 

4.11.2.8 THE LIST COMMAND 

LIST <start addr.> <end addr.> 

The LIST command displays the 8080/8085 mnemonic form of the bytes contained 
in the specified memory block. 

* DUMP 3000 3008 

3000 CA 02 37 B7 C3 lA 37 CB 
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♦LIST 3000 3008 

3000 JZ 3702 

3003 ORA A 

3004 J MP 371 A 
3008 CB * 

The memory block from 3000 to 3007 contains three 
The byte following the third Instruction is not a 
This is indicated by the '*' following its value. 

4.11.3 DEBUG MACHINE REGISTER AND FLAG COMMANDS 



8080/8085 instructions, 
valid 8080/8085 instruction. 



The DEBUG conmiands in this category are used in conjunction with DEBUG' s 
program execution control features during the process of monitoring a 
programs performance. Whenever the program execution is paused and the 



DEBUG Executive is waiting for a 
alter the state of the 8080/8085 
to the last instruction executed 

4,11.3.1 THE DISR COMMAND 



command, it 1s possible to display and/or 
registers and flags as they are relative 
in the program being monitored. 



DISR 

The DISR conuiand displays the contents of the processor registers and flags 
along with the next Instruction to be executed. In addition the contents 
of memory at locations addressed by register pairs (e.g. at the address 
contained in BC) along with the word on the top of the stack are displayed. 
Example: 

♦DISR 

A FLAGS BC DE HL SP §B §D !aH @SP 
00 ZCMEH 0000 0000 0000 1234 00 00 00 0000 
0000 LXI SP,1234 

The second line of the display indicates the processor state. The columns 
§B, @D, (an and iSP Indicate the contents of memory at the addresses contained 
in the respective register pairs. The flag values are indicated by the 
presence or absence of a character In the FLAGS column. The Z character 
indicates a zero condition, the C character a carry condition, the M 
character a negative sign condition (in the SIGN flag), the E character an 
even-parity condition and the H character a half-carry condition. Absence 
of any character indicates the opposite condition on the same flag. 

The third line displays the address and mnemonic of the next instruction 
to be executed. The address of the Instruction corresponds to the current 
value of the 8080 program counter (PC) register in the context of the program 
that DEBUG is monitoring. The Instruction is the one that will be executed 
next by a single step operation or when program execution is resumed by 
using a command such as the CONT or RET commands. Note that the state of 
the registers and flags as displayed by the DISR conmand reflects their 
values BEFORE the next Instruction shown on the third line is executed. 
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4.11.3.2 REGISTER SETT INS COMMANDS 

REGISTERNAME <hex number> 

The register setting coimiands allow the contents of the 8080/S085 processor 
registers to be set to a specified value prior to the execution of the next 
instruction in the program being monitored. The general format of a register 
setting command is a register name followed by a hex data value. 

The following register names may be used: 

A B C D E H L 

BC DE HL SP PC @SP 

The first line shows 8 bit registers and the second line shows 16 bit 
registers. PC is the program counter. I?SP designates the 15 bit word on 
top of the machine stack. 

The following examples would change the program counter value to 60F3, the 
A register value to 7, and the value at the top of the stack to CI 72. 

*PC 60 F3 
*A 7 

*@SP CI 72 

4.11.3.3 FLAG SETTING COMMANDS 

The flag setting commands allow the states of the 8080/8085 processor flags 
to be set or reset prior to the execution of next instruction in the program 
being monitored. The commands set the flag state according to the mnemonic 
form used in assembly language. The commands are: 

FZ FNZ FC FNC FP FM FPE FPO FH FNH 

The F2 and FNZ conroands set the state of the ZERO flaf-to zero or non-zero. 
The FC and FNC coranands set the state of the CARRY flag to carry or no carry. 
The FP and FM command set the state of the SIGN flag to positive or minus. 
The FPE and FPO commands set the state of the PARITY flag to even or odd. 
The FH and FNH commands set the state of the HALF-CARRY flag to half-carry 
or no half-carry. 

Examples: 

*FNZ 
*FC 

The state of the ZERO flag is set to non zero and the state of the CARRY 
flag is set to carry. 
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4.11.4 DEBUG MISCELLANEOUS UTILITY COMMANDS 

The two conwands in this category are the MATH comnand which is useful in 
doing address computations while engaged in a debug session, and the RST 
conroand which may be needed to avoid conflict with program usage of the 
processor restarts. 

4.11.4.1 THE MATH COMMAND 

MATH <hex number> <hex number> 

The MATH command performs a 16 bit integer addition and subtraction on the 
two specified hex numbers. It displays the sum and difference. The MATH 
command is useful for length and address calculations. Example: 

*MATH 4 5 

mm FFFF 

4+5 equals 9 and 4-5 equals FFFF. 

4.11.4.2 THE RST COMMAND 

RST <vector number> 

DEBUG normally uses the 'RST 6' restart vector of the 8080 or 8085 processor 
as its mechanism for Implementing breakpoints (see Section 4.11.5.1). Some 
computers and/or a particular program may already be using 'RST 6' for a 

different purpose. In this case it is possible to change the RST vector 
used by DEBUG to one of the other available RST's, 1-5 or 7. Example: 

*RST 7 

The RST vector used by DEBUG is changed to RST 7 from its default usage of 
RST 6. 

4.11.5 DEBUG PROGRAM EXECUTION CONTROL 

DEBUG offers 3 modes of control to monitor progress through a program; the 
breakpoint mode, the single step mode, and the trace mode. There is a 
permanent breakpoint facility normally used in conjunction with the corranands 
SET, DISB, CLR, EXEC and REPT. There is a temporary breakpoint facility 
used in conjunction with the conroands CONT and RET. The single-step mode is 
controlled with the space bar. The trace mode is a form of continuous single- 
stepping. Use of these modes and their associated corranands are detailed in 
this section. 

4.11.5.1 THE BREAKPOINT MODE 

Breakpoints provide a means to stop program execution at a given point. When 
program execution reaches that point control of the processor is transferred 

to DEBUG. Once In DEBUG, the results of the program section which was executed 
may be examined or modified. 
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In the breakpoint mode DEBUG replaces the instruction at a given address 
with one of the 'RST' instructions of the 8080/8085 (see 4,11.4.2 the RST 
command). Then DEBUG replaces the three bytes of code at the corresponding 
'RST' vector location with a 'JMP' instruction to a routine inside itself. 
DEBUG then loads the processor's registers with the stored 'user program 
register' values and transfers control of the processor to the user's program. 
When the breakpointed instruction address is executed, the 'RST' that DEBUG 
had placed at that location causes the processor to 'CALL' the RST vector 
location which then causes the processor to 'JMP' back to DEBUG. DEBUG then 
stores the processor's registers in the 'user program registers' and replaces 
the original contents of both the breakpointed instruction and the RST 
vector location. 

Because of the introduction of an 'RST' instruction into the program, when a 
breakpoint is encountered, at least one level of stack space must be available 
so that the return address back into the program can be stored. Therefore, 
when using the breakpoint mode the user must insure that at least one stack 
level will be, available when the breakpoint is encountered. 

Note that breakpoints cannot be used to DEBUG ROMed code because an 'RST' 
instruction cannot be patched into the code. 

When a breakpoint is encountered during program execution, DEBUG will display 
the contents of the program registers in the following format: 

A FLAGS BC DE HL SP @B @D @H @SP 
13 0000 0000 0000 01 A2 00 00 00 UFE 

Refer to the DISR cornnand section for a detailed description of this display. 

4.11.5.2 PERMANENT BREAKPOINTS 

Permanent breakpoints are set using the SET command. These breakpoints are 
not cleared when control of the processor is returned to DEBUG. Permanent 
breakpoints are only cleared by the CLR command. Permanent breakpoints can 
be used as traps on such things as error routines or executive loops. 

Note that permanent breakpoints do not leave a 'RST' instruction in the 
program code. The existence of a permanent breakpoint tells DEBUG to place 
a breakpoint in the code only when the program is executing. Thus the 
original program is intact whenever the DEBUG has control of the processor 

4.11.5.3 THE SET COMMAND 

SET <breakpoint #> <address> 

The SET command dennes a permanent breakpoint. The breakpoint # and the 
hex address at which the breakpoint will be set are entered with the command. 
More than one breakpoint # may be set with the same breakpoint address. 
However, an attempt to SET a breakpoint # which is already set will cause the 
message SYNTAX ERROR to be printed and the command to be ignored. A maximum 
of 4 breakpoint #'s may be set at any time. Example: 

*SET 1 2354 

Permanent breakpoint number 1 was set at location 2354 (hex). 
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4.11.5.4 THE DISB COMMAND 

DISS 

The DISB command displays all currently SET breakpoints. 
Example: 

DISB 
m 2354 
03 2365 

The display Indicates that breakpoint number 1 is set at address 2354 (hex) 
and breakpoint number 3 is set at address 2365 (hex). Breakpoints nunrtjer 
2 and 4 are not SET. 

4.11.5.5 THE CLR COMMAND 

CLR C<breakpoint #>] 

The CLR conmand clears a SET breakpoint. If the optional breakpoint number 
is not entered, then all SET breakpoints will be cleared. If a breakpoint 
number is entered but is not currently SET, the message SYNTAX ERROR will be 
displayed. 

Example: 

*CLR 1 

Permanent breakpoint number 1 is cleared. 

4.11.5.6 THE EXEC COHHAND 

EXEC <starting address> 

The EXEC command transfers control of the processor to the user's program. 
The processor's PC register will be set to the entered starting address and 
execution will start there. If a breakpoint is encountered, control of the 
processor will be returned to DEBUG. If no permanent breakpoints are SET 
at that time, the program will retain control of the processor. 

Example: 



*EXEC 3014 

A aAGS BC DE HL SP @B 
00 Z C 0012 0341 3674 0195 00 
3507 JMP 3643 



@D 
00 



m 

00 



@SP 
3054 



Program execution was started at location 3014 (hex). A breakpoint was 
encountered at location 3507 returning control back to DEBUG. 
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4.11.5.7 THE REPT COHWND 

KEPT <breakpoint #> <repeat count> 

The REPT command transfers control to the user's program until a permanent 

breakpoint has been hit a given number of times. The breakpoint number entered 

specifies the breakpoint address and the entered repeat count specifies the number 

of times it must be hit before control is transferred back to DEBUG. If any ■^ 

breakpoint other than the one being repeated is encountered, control will be 

transferred back to DEBUG and the repeat operation is cancelled. If the 

breakpoint # specified in the REPT conmand is not set, a SYNTAX error is displayed. 

Examp 1 e : 

*SET 1 3000 

*m E 2000 0000 0000 0000 00 00 00 0000 

3000 DCR B 

"^0 1F00 0000 0000 0000 00 00 00 0000 

3001 JMP 3000 
*REPT 1 8 

A FLAGS EC DE HL SP m @D iH ASP 

00 E 1800 0000 0000 01 A0 00 00 00 0000 

* 

The breakpoint at location 3000 (hex) is allowed to be passed over 8 times 
before control is transferred back to DEBUG and the processor state is 
displayed. 

4.11.5.8 TEMPORARY BREAKPOINTS / 

Tanporary breakpoints are one-shot breakpoints which the user instructs 
DEBUG to place in the program by using the CONT or RET commands. When 
control of the processor returns to DEBUG, the breakpoints are cleared. 
Temporary breakpoints are the type normally used to follow the execution of 
the program from routine to routine. 

4.11.5.9 THE CONT COMMAND 

CONT [<break 1> [<break 2> [<break 3> C<break 4>]]]] 

The CONT coimiand continues execution of the user's program at the current 
PC location with up to four temporary specified breakpoints. If no temporary 
breakpoints are specified, then control will never return to DEBUG unless an 
already specified permanent breakpoint is encountered. Example: 

*CDNT 356F 

A aAGS BC DE HL SP m @D §H @SP 
00 M 0120 0341 3674 0195 00 00 00 3054 

3507 DCR A 

* 

Program execution is resumed at the next instruction indicated by the value 
of the user program PC register and execution continues until the breakpoint 
at location 356F (hex) is encountered, which returns control back to DEBUG. 
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4.11.5.10 THE RET COMMAND 

RET 

The RET command transfers control of the processor to the user's program 
with a temporary breakpoint set at the address which is on the top of the 
stack (laSP). This allows the user to 'RETURN' from a subroutine which was 
'CALL'ed by the program. 

If a breakpoint other than the 'RET' breakpoint is hit, control will return . 
to the DEBUG and the 'RET' breakpoint will be cleared. 

Note. The RET command should only be used after a 'CALL' type instruction 
has been executed or when the top of the stack contains a known return 
address. Otherwise a breakpoint might be placed at an address which is not 
a part of the program, (e.g. the last instruction was a 'PUSH' and therefore 
the top of the stack contains a data word instead of a return address) 
Example: 

*DISR 

A aAGS BC OE HL SP m ID !3H @SP 

00 Z 0000 0000 0000 0000 00 00 00 0000 

2A00 LXI SP,3000 

*00 Z 0000 0000 0000 3000 00 00 00 3243 

2A03 CALL 2800 

*00 Z 0000 0000 0000 2FFE 00 00 00 2A06 

2800 STC 
*RET 

A FLAGS BC DE HL SP @B SD m §SP 

00 ZC 0000 0000 0000 3000 00 00 00 3243 

After the second Instruction single-step, the RET coimiand causes a temporary 
breakpoint to be set at location 2A06 (which is the return address on the top 
of stack) and program execution is resumed. Wheii the program reaches 2A06 
control of the processor 1s returned to DEBUG and the processor state is 
displayed. 

Exception Note: The following program fragment illustrates a special 
prograirming construct with which the RET conmand can not be used. 

Can MESSAGE 
TEXT DTH 'SIGNON' 

RET 

MESSAGE XTHL 

CALL aiNEOUT 

INK H 

RET 

If an RET cormiand is given after the call to MESSAGE has just been executed, 
the return address on the top of the stack is pointing to location TEXT. 
DEBUG puts a breakpoint at that location. MESSAGE then outputs the Signon 
text and returns without encountering the breakpoint because the return 
address has been modified by the called routine. 
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4.11.5.11 THE SINGLE STEP MODE 

The single-stepping mode of program execution allows a detailed inspection 
of what the program is doing on an instruction by instruction basi: E:ct' 
time the space bar is pressed in response to the DEBUG '*' prompt, DEBUG 
causes the next instruction in the program to be executed and displays 
the contents of the processor registers. 

Example: 

*DISR 

A FLAGS BC DE HL SP §B §0 @H @SP 

13 00530 0000 0000 01A2 00 W m 14FE 
2A00 STC 

*13 C 0000 0000 0000 01 A2 00 00 00 14FE 

2A01 XRA A 

*00 Z E 0000 0000 0000 01 A2 00 00 00 14FE 

2A02 STA 345 F 

At the '*' prompt the user typed a space which caused DEBUG to single-step 

an instruction and print the resulting register contents on the same line. 

In the single-step mode of operation, DEBUG makes a local copy of the instruction 

to be executed in Its own buffers. DEBUG then executes the instruction in its 

buffers and stores the results. The single-step mode does not need to modify 

the program in any way which allows programs in ROM may be stepped through 

without problem. 

4.11.5.12 THE TRACE MODE COMMAND 

TRACE 

The TRACE command operates as a continuous single-stepping command. It is 
used to provide a trace printout of the user's program. During a TRACE the 
Control S / Control functions provide pause and break control . 

Example: 

*TRACE 
00 E 1800 0000 0000 01 A0 00 00 00 0000 
3001 JMP 3000 
00 E 1800 0000 0000 01 A0 00 00 00 0000 

3000 OCR B 

00 E 1700 0000 0000 01 A0 00 00 00 0000 

3001 JMP 3000 

00 E 1700 0000 0000 01 A0 00 00 00 0000 

3000 OCR B 

00 1600 0000 0000 01 A0 00 00 00 0000 

3001 JMP 3000 

* 

The program was put in TRACE mode. The Control C key was pressed and stopped 
the TRACE after 5 instructions had been executed. 
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Exception Note: The nature of Micropolis disk subsystems is such that a 
disk access must not be interrupted during the data transfer process which 
is accomplished by a program loop. For this reason it is not possible to 
TRACE successfully through portions of a program that call MDOS disk access 
routines, because the TRACE command effectively interrupts the program once 
e^/e^y instruction. 

4.11.6 INITIATING A DEBUG SESSION 

Both DEBUG and the program to be monitored must be in memory at the same 
time. The program is loaded into meirory first by using the LOAD conmand 
from the MDOS executive. DEBUG is then invoked from the MOOS executive 
by typing the name of a configured DEBUG version as created by OEBUG-GEN 
(see Section 4.12). The version invoked should not use any iT«mory space 
that is required by the program to be ironitored. Example: 

>LOAD "TEST PROGRAM" 

>DEBUG 

MICROPOLIS DEBUG V.S. X.X - COPYRIGHT 1978 



DEBUG signs on and displays its executive prompt. Monitoring of program 
execution Is now controlled from the DEBUG executive. 

If the program to be monitored is one which runs in the MDOS Application 
area, and which requires one or irore ASCII or binary parameters that are 
normally input as part of an MDOS Executive statement, then the way to 
initiate program execution control 1s by SETting a permanent breakpoint 
at the address of the entry point (first instruction) of the program and 
then EXECuting the MOOS Executive at the warmstart address which 1s 4E7H. 
Example: 

*SET 1 2800 

*EXEC 4E7 

MICROPOLIS MDOS V.S. X.X - COPYRIGHT 1978 

>APP "ASCIIPARM" 12 

A FLAGS EC DE HL SP §B §D fH @SP 

2B00"Lxi"sp",'01A0 

Permanent breakpoint number 1 is set at the program entry point 2B00 hex 
and execution is begun at the system warmstart address. The MDOS executive 
signs on and prompts for a command. The APP conroand 1s used to transfer 
control to the start of the program in the application area and to pass 
one ASCII and one numeric parameter. The breakpoint Is then encountered. 
DEBUG outputs a register display and waits for additional single-step, 
breakpoint or other commands. 
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If the program to be monitored is one which can be executed directly without 
requiring any parameters from the MDOS executive, then the simplest way 
to initiate program execution control is to set the PC register to the program 
entry point address. Set the stack pointer to an appropriate address and then 
use the CONT cormiand to set a temporary breakpoint at the first desired stop 
point and transfer control to the program. Example: 

*PC 30W 
*SP 1A0 
*CONT 3020 

The program counter is set to 3000 hex and the stack is set at 1A0 hex. A 
temporary breakpoint is set at 3020 hex and program execution is begun at 
the PC value, 3000 hex. When the temporary breakpoint is encountered DEBUG 
will output a register display and wait for a new comnand. 

4.11.7 EXITING DEBUG 

The user may exit DEBUG in one of two ways. First, the user may simply 
transfer control of the processor to the program permanently. This is done 
by clearing all permanent breakpoints with the CLR command and then using 
the CONT command without setting any temporary breakpoints. Second, the 
user may simply return to the MDOS executive. This is done by CLRing all 
permanent breakpoints and then typing: 

*EXEC 4E7 

This warmstarts the MDOS executive and leaves the program without any 
breakpoints set. 

4.11.3 RE-ENTERING DEBUG 

If control of the processor has been permanently given to the program, DEBUG 
may be restarted by executing the first address of the IK boundary on which 
DEBUG is running. This 'warmstart' procedure will cause any breakpoints 
which were set in the program to be replaced by the original instructions. 

An example of a situation where a restart of DEBUG would be necessary is as 
follows. A breakpoint was set in the program and control transferred by a 
CONT comnand. However, the program entered a loop which had a bug such that 
the loop was never exited. This caused the system to lock up. The only 
way to get control back to DEBUG is by restarting DEBUG. 

4.11.9 SAMPLE PROGRAM DEBUGGING SESSION 

This section contains a sample debugging session as an example of the use of 
various DEBUG features. The program being DEBUGged is listed in 4.11.9.1. 
Assume that the program and DEBUG are on disk unit along with an MDOS 
system. The actual debugging session is shown in Section 4.11.9.2. 
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4.11.9.1 SAMPLE PROGRAM LISTING 



3000 16 00 


0000 


fWI 


D,0 


3002 21 80 02 


0010 


LXI 


H,280H 


3005 CD 30 


0020 LOOP: 


CALL 


SUB 


3008 25 


0030 


DCR 


H 


3009 C2 05 30 


0040 


JNZ 


LOOP 


300C 7D 


0050 


MOV 


A,L 


300D 0F 


0060 


RRC 




300E 6F 


0070 


MOV 


L,A 


300 F D2 05 30 


0080 


JNC 


LOOP 


3012 C9 


0090 


RET 




3013 F5 


0100 SUB: 


PUSH 


PSW 


3014 7C 


0110 


MOV 


A,H 


3015 B5 


0120 


ORA 


L 


3016 Fl 


0130 


POP 


PSW. 


3017 C9 


0140 


RET 




4.11.9.2 DEBUGGING SESSION 







The following text is a description of the debugging session listing which 
follows. 

The first three lines show the test program being loaded into memory along 
with the load and execution of the DEBUG. Once DEBUG is loaded and running 
it signs on and displays its executive prompt '*'. At that point the PC 
and SP registers are initialized so that the program can be tested. A 
permanent breakpoint is set at the final RET instruction so that the program 
will not return illegally. Then the first three instructions of the program 
are single-stepped leaving the program inside the subroutine. The subroutine 
is RETurned from and execution is allowed to proceed to location 300C using 
the CONT command. Then the TRACE command is used to let execution proceed. 
The TRACE is cancelled at location 3005. A permanent breakpoint is SET and 
the REPT command used to allow the inner loop (the CALL, DCR H and JNZ) to 
execute twice. After two loops control returns to DEBUG. The second 
breakpoint (the one used for the REPT) is cleared and the program is allowed 
to execute to the final RET instruction. Having finished testing the program, 
MDOS is wannstarted. 

MICROPOLIS MDOS V.S. 4.0 - COPYRIGHT 1978 



>LOAD "TEST" 
>DEBUG-70 



load program into memory 
run debug (7000 hex) 



MICROPOLIS DEBUG V.S. 4.0 - COPYRIGHT 1978 



*SP 1A0 
*PC 3000 



set up a stack 
set up PC 



Rev. 8 9/78 



4-89 



*OISR 

A FLAGS BC DE HL SP 98 fO @H @SP 

80 ZC E 0000 0000 0000 01 A0 C3 C3 C3 5845 

3000 MVI D,00 

*SET 1 3012 set breakpoint on final RET 
*OISB 

01 3012 

*80 ZC E 0000 0000 0000 01A0 C3 C3 C3 5845 single-Step 

3002 LXI H,0280 

*B0 ZC E 0000 0000 0280 01 A0 C3 C3 11 5845 single-step 

3005 CALL 3013 

*80 ZC E 0000 0000 0280 01 9E C3 C3 11 3008 single-step 

3013 PUSH H 

*RET return from SUB call 

A FLAGS BC DE HL SP m @D iH ?SP 

02 M 0000 0000 0280 01 A0 C3 C3 11 5845 
3008 DCR H 

*CONT 300C set temporary break and go 

A FLAGS BC DE HL SP @B HO @H (3SP 

01 Z E 0000 0000 0080 01 A0 C3 C3 0A 5845 

300C MOV A,L 

♦TRACE trace execution 

80 Z E 0000 0000 0080 01 A0 C3 C3 0A 5845 

300 D RRC 

40 Z E 0000 0000 0030 01 A0 C3 C3 0A 5845 

300E MOV L,A 

40 Z E 0000 0000 0040 01 A0 C3 C3 0A 5845 

300F JNC 3005 

40 Z E 0000 0000 0040 01 A0 C3 C3 0A 5845 

3005 CALL 3013 Control C hit here 

*SET 2 300C set permanent break 

*REPT 2 2 execute inner loop twice 

A FLAGS BC DE HL SP PB m @H @SP 

20 Z E 0000 0000 0020 01A0 C3 C3 0A 5845 

300C MOV A,L 

*CLR 2 clear breakpoint 2 

*OISB display breakpoints 

01 3012 

*CONT complete program 

A FLAGS BC DE HL SP §B SO OH !3SP 

80 ZC E 0000 0000 0080 01 A0 C3 C3 0A 5845 

3012 RET 

*CLR clear all breakpoints 

*EXEC 4E7 warmstart MOOS 

MICROPOLIS MOOS V.S. 4.0 - COPYRIGHT 1978 
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4.11.10 USING DEBUG WITH BASIC 

DEBUG is designed so that it 1s independent of the MtX)S executive. The 
only part of PDS on which DEBUG relies is the console and printer I/O 
logic contained in the RES module. This independence makes it possible to 
use DEBUG in conjunction with Micropolis BASIC to debug user written 
machine language routines that BASIC accesses via its DEF FAA construct. 

To use DEBUG in this way, its filetype must be changed to an overlay type 
C, so that it may be accessed with the BASIC LINK statement. This can be 
done from the MDOS executive by using the TYPE command. 

The BASIC program and the machine subroutine should be loaded prior to 
accessing DEBUG. Also the end of BASIC'S remory space must avoid conflict 
with the machine routine and the particular version of DEBUG being used. 
When these conditions are met DEBUG can be accessed from the BASIC monitor 
by using the stataitent LINK "DEBUG-XX". Example: 

MICROPOLIS BASIC V.S. X.X - COPYRIGHT 1978 

READY 

LOAD "BASICPGM" 

READY 

LIST 

l!3 DEF FAA=16R7010 

20 A=FAA (1) 

30 PRINT A 

40 END 

READY 

MEMEND 16R7000 

READY 

LOAD "MROUTINE" 

READY 

LINK "DEBUG-74" 

MICROPOLIS DEBUG V.S. X.X - COPYRIGHT 1978 

*SET 1 7010 
*EXEC 4E7 

MICROPOLIS BASIC V.S. X.X - COPYRIGHT 1978 

READY 

RUN 

A FLAGS .... 

DEBUG Register display 

7010 PUSH H 
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From the BASIC monitor the file "BASICPGM" is loaded and listed. It is a 
program that accesses a machine language routine beginning at address 7010 
hex. BASIC'S end of memory is set to 7000 hex and the machine routine 
"HROUTINE" is loaded in above the end of BASIC. A version of DEBUG which 
starts at 7400 hex is then linked to. In DEBUG a permanent breakpoint 
is set at 7010 hex, the beginning of the machine routine. Control is then 
transferred to the system warmstart address 4E7 hex and BASIC signs on 
again. A RUM command starts execution of the BASIC program, which accesses 
the machine routine when line 20 is executed. The DEBUG breakpoint is 
encountered and DEBUG outputs a register display and waits for a conmiand. 
The machine routine accessed from BASIC may now be stepped through or 
otherwise debugged as required. 

4.12 THE DEBUG-GEN UTILITY 

The Micropolis DEBUG program is supplied in a non-configured form embedded 
within the DEBUG-GEN utility program. Before DEBUG can he used an executable 
version must be obtained by running the DEBUG-GEN utility. 

DEBUG requires 4K of contiguous memory address space which may start on any 
IK boundary above the beginning of the MDOS applications area. DEBUG-GEN 
accepts a memory space specification and creates a version of DEBUG that 
uses the specified memory space. 

From the MDOS executive, DEBUG-GEN is invoked by entering the filename 
DEBU6-GEM like an executive statement (see Section 4.1.2) or by entering 
the command LOAD "DEBUG-GEN" followed by the command APP. 

The program signs on with the message 

DEBUG GENERATION PROGRAM VS. X.X. 

and profTipts for the memory address at which the DEBUG will run with the 
message 

ENTER PAGE ADDRESS (2C-F0) ? 

Type a two digit hexadecimal number that corresponds to the high-order byte 
of the start address where the DEBUG will run. This address may only be on 
a IK boundary. The program will ignore the lowest 2 bits of the response. 

DEBUG-GEN creates a type 14 file on disk unit and fills it with the 
relocated DEBUG system. The file name is "DEBUG- XX" where XX (hex) is the 
page address entered by the user. 
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Example: 

MICROPOLIS MDOS V.S. 4.0 - COPYRIGHT 1978 

>0EBUG-GOI 

DEBUG GENERATION PraGRAM V.S. X.X 

ENTER PAGE ADDRESS {2C-Fi) ? 70 

RUN FILE NAMED DEBUG- 70 
> 

In this example a program file named "DEBUG-70" ts created on disk unit 0. 

This file is a running DEBUG package which will use the marory space from 
7000H to 7FFFH. 
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V MICROPOLIS DISK EXTENDED BASIC 

5.0 INTRODUCTION 

Micropolis Program Development Software consists of two systems, the Micropolis 
Diskette Operating System (MOOS) and Micropolis Disk Extended Basic. Both 
systems are supplied on a MASTER diskette included with each Micropolis disk 
subsystem. The auto-load bootstrap brings MDOS, which is the first system on 
the diskette, into memory. Control is transferred from HDOS to BASIC by 
typing the filename BASIC to the MDOS executive. It is also possible to create 
a BASIC only diskette so that BASIC may be directly loaded by the bootstrap 
system.- See Chapter II, Section 2. This chapter describes the Micropolis 
BASIC interpreter and its associated BASIC programming language. 

The Micropolis BASIC Interpreter Is a special 8080 machine language program 
supplied on a master diskette included with the disk subsystem. It provides 
a simple and powerful means for developing, maintaining and executing BASIC 
programs on 8080 type microcomputer systems. The user interacts with the 
Interpreter through a terminal which consists of an input keyboard and an 
output display that may be video or printed hardcopy. Lines entered at the 
keyboard may be program lines which are stored in the program buffer or 
commands for immediate execution. A program In the program buffer may be 
modified In place, stored as a disk file, retrieved from disk and executed 
under control of the Interpreter. These functions and others are Invoked 
by entering the appropriate immediate commands. Elements of the BASIC 
Interpreter and Its use are described in Sections 5.1 and following. 

The original BASIC programming language was developed by John Keneny and 
Thomas Kurtz at Dartmouth College, Hanover, New Hampshire; 'Micropolis 
Extended Disk BASIC is an elaborated version of that language. BASIC 
consists of data types, operators, function references and key words which 
combine to form statements that can be grouped into executable BASIC 
programs. The details of these language elements and the rules for com- 
bining them are described 1n sections following. 

5.1 ENTERING LINES TO THE BASIC INTERPRETER 

The BASIC Interpreter Is loaded into the main computer memory from MDOS 
or booted from a BASIC only diskette. At the end of this procedure the 
message READY Is displayed at the terminal. This means that the Interpreter 
is in control and is waiting for a line to be input. 

A line consists of not more than 250 characters typed in sequence. The 
entry of a line is terminated by depressing the RETURN key. If nwre than 
250 characters are typed prior to the RETURN the Interpreter will output 
the message INPUT OVERFLOW and cancel the entire line. 

During the entry of a line each character that is typed is echoed by the 
Interpreter on the terminal display. If the character typed is not part 
of the BASIC character set (see Section 5.15) it will not be echoed and 
will not be Included in the line entered. The Interpreter also keeps 
track of the character count as a line is typed and automatically outputs 
a carriage return / line feed combination to the terminal display when 
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the count exceeds the width of the display device. This combination is not 
included in the line count. 

Two control features may be used when entering a line. 

1) when DEL or RUBOUT key is depressed the next previously 
typed character will be deleted from the line. A back arrov^ 
is echoed to the terminal display for each character deleted. 
Neither the deleted characters nor the back arrows are included 
in the line count. 

2) Holding down the control key and typing X (CNTL/X) will cause 
all of the current line to be cancelled. A carriage return 
line feed combination is echoed to the terminal display; the 
Interpreter is positioned to accept entry of a new line. 

5.2 ENTERING A PROGRAM 

The BASIC Interpreter recognizes a line as a program line by the presence 
of a leading line number. A BASIC program is entered one program line at 
a time using the normal line entry procedures. The message READY is not 
displayed after the entry of a program line. This permits consecutive 
program lines to be entered conveniently. As each program line is entered 
the Interpreter stores' it In a program buffer which it maintains in the 
computer system's main memory. 

Each line of a BASIC program Is composed of a line number followed by one 
or more statements (see Section 5.20) which are separated from each other 
by a colon (:). The length of a program line may not exceed 250 characters 
Including the digits in the line number. Each line number must be within 
the range - 65529. Spaces preceding the first digit of a line number 
are ignored. Spaces embedded in a line number are not legal. All other 
spaces in a program line are preserved as entered.. 

Program lines are stored in the program buffer in numeric order by line 
number. The lines in the buffer at any given time constitute the current 
program. This program may be modified in three ways. 

To insert a new program line, type in the new line including the line 
number. The interpreter will automatically place the new line In the 
program buffer in proper sequence. 

To modify an existing program line enter the line number and the new 
statement or statements. The new line will automatically replace the 
old line in the program buffer that has the same line number. 

To delete an existing program line type the line number followed by carriage 
return. The corresponding line will be eliminated from the program buffer. 
Mote that multiple lines may also be eliminated by using the DELETE command 
as described in 5.4. 
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5.3 IMMEDIATELY EXECUTED LINES 

Whenever a line 1$ typed in, the Interpreter scans it from left to right 
until the first non blank character is encountered. If this character is 
a digit it is assumed to be the first digit of a line number and the line 
is treated as a program line, {see Section 5.2). If the first non blank 
character is not a digit then the line is interpreted for immediate 
execution. 

Most normal BASIC statements may be entered for immediate execution. 
Exceptions are the DEF FN, DEF FA, and DATA statements vrtiich are only 
functional within a program. Multiple statements may be included in an 
imnwdiate line by separating them with colons {:)• BASIC statements are 
covered in Section 5.20. 

Another form of inmediate line is the coimand. Coinnands are operations 
which generally make sense only in immediate mode. Most of the commands 
in BASIC system relate to the program buffer and to the manipulation and 
execution of BASIC programs. The available commands are described in the 
following sections. 

EDIT, RENUM and MERGE are three comnands which function only in the immediate 
mode. These commands cause a SYNTAX error if they appear in a program. 

5.3.1 THE BASIC EDIT COMMAND 

EDIT linenumber 

A specified line in the BASIC program buffer can be changed without retyping 
the entire line by using the EDIT comnand. EDIT linenumber is the form of 
this command. If the specified linenumber is not found in the current program 
buffer, the message STMT # NOT FOUND is displayed. BASIC processes an EDIT 
corimand by copying the specified line into a special editing buffer and 
setting an invisible pointer to point to the first digit of the linenumber 
that begins the text Hne. BASIC Is then in the EDIT command mode. A 
separate set of single key commands is available for editing a line In the 
special edit buffer. The whole Hne Including the linenumber can be edited. 

5.3.1.1 ADVANCING THE BASIC EDIT POINTER - THE SPACE BAR 

The invisible edit pointer in the special editing buffer may be advanced 
one position by pressing the space bar one time. The character to which 
the edit pointer is pointing will be displayed on the console. This 
indicates that the edit pointer has passed over the character. The edit 
pointer is then advanced so that it is now pointing at the next character 
in the text line immediately after the one that is displayed. The entire 
line can be displayed in this manner. 

5.3.1.2 CHANGING THE NEXT CHARACTER - C 

The character to inrfiich the edit pointer is pointing in the edit buffer 
can be changed by typing a c or C, followed by the new character. 
The new character is printed on the console and replaces the character 
in the edit buffer at that position. The edit pointer is advanced to 
point to the character infimediately after the new displayed character. 
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5.3.1.3 DELETING THE NEXT CHARACTER - D 

The character to which the edit pointer is pointing in the edit buffer 
can be deleted by typing a d or D. The deleted character is printed 
on the console enclosed in backslashes (/). The edit pointer is left 
pointing at the character immediately after the deleted character. 

5.3.1.4 INSERTING CHARACTERS - I 

Characters may be inserted into the line or at the end of the line by 
typing an i or I followed by the characters to be inserted. The 
insertion begins iranediately before the character pointed to by the 
edit pointer. Characters are inserted in sequence as typed until the 
insert mode is terminated by depressing the ESCkey. The edit pointer 
remains pointing to the same character that it pointed to when the insertion 
began. The. insert irode may also be terminated by pressing the return key. 
This also terminates the EDIT comnand and replaces the line in the current 
text file with the newly edited version from the special editing buffer. 

5.3.1.5 LISTING THE LINE IN THE SPECIAL EDITING SUFFER - L 

The remainder of the line in the special edit buffer from the position 
of the edit pointer to the end of the line may be displayed by typing an 
1 or L. The characters are displayed on the console followed by a carriage 
return-line feed. The edit pointer is reset to the beginning position. 
This command is useful to see what the line looks like before editing is 
completed. It may also be helpful to use this conmand immediately after 
entering the original EDIT conmand. This would display the line about to 
be edited without exiting the editing mode. 

5.3.1.6 SEARCHING TO A SPECIFIED CHARACTER - S 

The edit pointer may be advanced in the special editing buffer to the first 
occurrence of a specified character by typing an s or S followed by the 
character to search for. The characters from the position of the edit 
pointer up to but not including the searched for character are printed on 
the console. The edit pointer is left pointing at the first occurrence of 
the searched for character. If the search argument does not exist in the 
line then the entire line is printed and the edit pointer is positioned at 
the end of the line. 

5.3.1.7 DELETING TO A SPECIFIED CHARACTER - K 

Characters in the special editing buffer from the edit pointer position 
up to but not including a specified search character can be deleted by 
typing a k or K followed by the search character. The deleted characters 
are displayed on the console, enclosed in backslashes (/). If the search 
argument does not exist in the edit line, then all the characters from the 
edit pointer to the end of the line are deleted. The edit pointer is left 
pointing at the search character or at the end of the line. 
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5.3.1.8 QUITTING THE BASIC EDIT COMMAND MODE - 

The EDIT command may be aborted without changing the line in the current 
text file by typing a q or Q. The partially edited line in the special 
editing buffer is abandoned. No changes are made to the current program 
buffer. BASIC is ready to accept a new command. 

5.3.1.9 COMPLETING THE BASIC EDIT COMMAND - THE RETURN KEY 

The line in the special editing buffer can be placed in the current program 
buffer by pressing the return key at any point while in the BASIC EDIT 
comnand mode. If the line number of the line in the special edit buffer 
matches a line number in the current program buffer, then the edited line 
replaces the corresponding line in the program buffer and the EDIT mode is 
completed. If there is no line in the current program buffer with the same 
line number as the line in the special edit buffer, then the edited line is 
inserted into the current program buffer in proper line number order. This 
feature facilitates the copying or repetition of program lines by changing 
only the line number during the edit. 

5.3.2 THE RENUM COMMAND 

RENUM 

RENUM (starting-number) 

RENUM (starting-number, increment) 

RENUM (starting-number, increment, first-line-to-change) 

Some or all of the lines in the current program buffer can be renumbered by 
using the RENUM conmand. This command renumbers lines in the program, changing 
line numbers, and line number references that follow branch statements. 
These statements are GOTO, GOSUB, ON... GOTO, 0N...60SUB, THEN, RESTORE. The 
ERROR, END, and ENDPAGE options of the OPEN statement are also affected. 

The forms of this command are RENUM, RENUM (starting-number), RENUM (starting- 
number, increment), and RENUM (starting-number, increment, first-line-to-change). 
RENUM takes the line number of the first-line-to-change and sets it equal to 
the starting-number. The line number of each line after the first-line-to-change 
is then set to the value of the preceding new line number plus the increment 
value. If no first-line-to-change is specified, the first line in the program 
buffer is assumed. If no increment value is specified, the value 10 is used. 
If no starting-number is specified, the value 10 is used. Typing RENUM alone 
will produce a program numbered from 10 by 10' s. Examples: 

Assume that the current program buffer contains the following program: 

9 REM RENUM EXAMPLE PROGRAM 

25 INPUT "VALUE" •,A 

30 PRINT "THE SQUARE ROOT OF" ;A;"IS" ;SQR(A) 

45 GOTO 25 

The command RENUM (50,30,30) would produce the following: 

9 REM RENUM EXAMPLE PROGRAM 

25 INPUT "VALUE" ;A 

50 PRINT "THE SQUARE ROOT OF" •,A;"IS" •,SQR(A) 

80 GOTO 25 
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The command RENUM would produce the following: 

10 REM RENUM EXAMPLE PROGRAM 

20 INPUT "VALUE" ;A 

30 PRINT "THE SQUARE ROOT OF" ;A;"IS";SQR(A) 

40 GOTO 20 

The command RENUM (100) would produce the following: 

100 REM RENUM EXAMPLE PROGRAM 

110 INPUT "VALUE" ;A 

120 PRINT "THE SQUARE ROOT OF"-,A;"IS" ;SQR(A) 

130 GOTO 110 

The command RENUM (1000,100) would produce the following: 

1000 REM RENUM EXAMPLE PROGRAM 

1100 INPUT "VALUE" -.A 

1200 PRINT "THE SQUARE ROOT OF";A;"IS" ;SQR(A) 

1300 GOTO 1100 

Several error conditions are checked before any renumbering is done. This 
is to safeguard the program against possible damage. As errors are detected 
error messages are printed along with the lines where the error occurred. No 
changes are made to the program if any errors are encountered and no 
renumbering can be successfully carried out until the errors are corrected. 

Entering a RENUM comnand may result in the message NUMBER OUT OF RANGE 
followed by the line where the error occurred. This is an indication that 
the renumbering attempt lead to a line nurAer greater than 65529. This can 
be corrected by entering a RENUM with a smaller increment value that does 
not cause a line number greater than 65529. 

Entering a RENUM command may result in the message MEMORY OVERFLOW. This 
indicates that renumbering would create a program to long to be run in the 
memory currently available to BASIC. The program is not renumbered. 

Entering a RENUM command may result in the message STMT # NOT FOUND without 
printing the offending line. This occurs when the specified 
first-line-to-change does not exist in the program. No change is made. 
Example; if the program is: 

10 PRINT "TEST" 
20 GOTO 10 

The command RENUM (100,10,30) would cause a STMT # NOT FOUND error because 
there Is no line 30 at which to start renumbering. 

Entering a RENUM command may result in the message STMT # NOT FOUND followed 
by the line where the error occurred. This indicates that a branch statement 
(GOTO.GOSUB, etc.) contained a reference to a line number that does not exist 
In the program. If this 1s intentional a stub line should be placed In the 
program to allow the RENUM to operate. This can be done by typing the line 
number with a REM statement as a place holder. 
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Entering a RENUM coimand may result in the message SYNTAX ERROR. This can 
be caused by several types of syntactical errors. If the line contains 
unbalanced quotes or parentheses the SYNTAX ERROR message is displayed, or 
if renumbering would cause a sequence error in the line numbering (e.g. the 
lines were numbered 10,20,30,40 and you typed RENUM (10,10,30). This would 
result in numbers 10,20,10,20 which is not allowed.). 

The RENUM coimand does not change line numbers following LIST, or DELETE. 
If these statements are used within a program they must be changed manually. 

RENUM will not renurter line number references In scientific notation (1E3), 
or expressions (GOTO 90*8+3). Such references must be changed manually. 

If computed GOTO's, GOSUB's or RESTORE 's are used in the program they will 
more than likely be incorrect after renumbering unless extreme care is 
taken 1n selecting the renumbering parameters. 
Example-, if the program is: 

10 DATA THIS, IS, A, TEST 

20 DATA MORE, TEST, HERE, END 

30 INPUT "WHICH DATA,! or 2", A 

40 RESTORE (10*A) 

50 READ A$,B$,C$,D$ 

The command RENUM (100,10,30) would renumber the executable part of the 
program while leaving the DATA statements unchanged. 

10 DATA THIS, IS, A, TEST 

20 DATA MORE, TEST, HERE, END 

100 INPUT "WHICH DATA.l OR 2", A 

110 RESTORE {10*A) 

120 READ A$,B$,C$,D$ 

The computed RESTORE on line 110 would still function after the program is 
renumbered. However, if lines 10 and 20 had been renumbered, then the 
program would not perform as intended. 

The RENUM command can cause a line to expand to a length greater than 250 
characters. Such a long line can only be created by RENUM and could not be 
entered from the keyboard because the input buffer 1s only 250 characters 
long. The Basic EDIT conmand uses the 250 character input buffer during 
editing. If renumbering causes a line longer than 250 characters and that 
line is later edited using the Basic EDIT conmand the line will be truncated 
at 250 characters by the editor. 

5.3.3 THE MERGE COMWND 

MERGE "unit#:fnename" 

The MERGE conmand allows existing program files on disk to be incorporated 
with a program presently in the BASIC program buffer. The form of the 
command is MERGE "unit#: filename". The unit# is a number from to three 
followed by a colon. If no unit number is specified, unit zero is assumed. 
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Lines are merged one at a time from the merge file into the current program 
buffer, starting with the first line in the merge file. If the line number 
in the merge file is the same as a line number presently in the program 
buffer, then the line from the file replaces the line in the buffer. If the 
line number in the merge file does not match any line number in the program 
buffer, then the line from the file is inserted in the current program 
buffer in proper line number order. When all lines from the merge file have 
been placed in the program buffer the MERGE is complete. 

The entire merge file is loaded into memory following the program in the 
program buffer. Therefore the length of program in the program buffer plus 
the merge program must be less than the space currently available to BASIC, 
otherwise a LOAD OVERRUN message is output and the irerge does not take place. 

The MERGE command also needs some additional buffer space to perform the 
merge. If there is not enough room the message METORY OVERFLOW is output 
and the merge does not take place. 

Large programs are often developed as modules. Each module is written with 
its test data and debugged separately. The following example shows a three 
part survey program. Part 1 reads the survey data and talleys the vote. 
This module is allocated line numbers from 1000 to 2000. The data has been 
allocated lines 10 to 100 and the printer output module is allocated lines 
5000 to 6000, 

The program under test uses lines 10-30 as test data, and lines 5000-5010 
prints the test results. The program looks as follows in the program buffer: 

10 REM LIVE DATA SUPPLIED BY OTHER PART OF PROGRAM 

20 REM TEST DATA. 

30 DATA 1,1,2,2,3,3,4,4.0,1,4,1,99 

1000 REM PROCESS SURVEY MODULE. 

1010 T=l :REM INIT TOTAL COUNTER 

1020 REM VALID DATA IS 0=NO OPINION, 1=YES,2=N0,99=END OF DATA. 

1025 READ C 

1030 IF C=0 THEM T1=T1+1 

1040 IF C=l THEN T2=T2+1 

1050 IF C=3 THEN T3=T3+1 

1060 IF C=99 THEN T=T-1:G0T0 5000 

1070 IF C<0 OR OZ AND C<>99 THEN PRINT " ITEM" ;T;" NOT VALID" 

1080 T=T+1 

1090 GOTO 1025 

5000 REM TEST PRINT OUT ROUTINE 

5010 PRINT "NO OPINION'" ;T1;" YES=";T2;" N0=";T3;" TOTAL'" ;T 

This process module with the temporary test data and print logic can be 
separately tested, debugged and then saved on disk with the command SAVE "PARTI". 

The real print module can then be developed as follows: 

DELETE 

5000 REM PRINT WOULE 

5010 OPEN 1 "*P" ERROR 5200 

5020 A$="ZZ9":8$="VZ9" 

5030 P1=T1/T:P2=T2/T:P3=T3/T 

5040 IF P1+P2+P3O100 THEN PRINT"PERCENT ERROR" :STOP 

5050 PUT 1 TAB (60); "NO" 
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1060 PUT 1 TAB(10);"RESPONSES";TAB(25);"YES %" ;TAB(46)"M0 %" ; 

5070 PUT 1 TAB{6?)"0PINI0N 1^" 

5080 PUT 1 REPEAT$("=",72) 

5090 PUT 1 TAB(12);FMr(T,A$);TAB(25);FMT(Tl,A$);TAB{30);FMT(P1,B$); 

5100 PUT 1 TAB(45);FMr(T2,A$);TAB(51);FMT(P2,B$);TAB(60)-,FMT(T3,A$); 

5110 PUT 1 TAB(69);FMT(P3,B$) 

5120 PUT 1 REPEAT${"-",72) 

5130 CLOSE 1 : STOP 

5200 PRINT ERR$:INPUT"CONTINUE",C$:aTO 5020 

When the real print module is debugged the coranand SAVE "PART2" saves It on 
the disk. 

To test the system PARTI and PART2 are contlned by typing the commands 
LOAD "PARTI" and a carriage return, and then the comnand MERGE "PART2" and 
a carriage return. The combined programs are RUN using the test data. When 
these parts are debugged they are saved on disk by typing the command SAVE 
"PROGRAM" and a carriage return. 

The data is entered into a separate file as follows: 

DELETE 

10 REM LIVE DATA 

20 DATA 1,1,1,2,2,1,0,1,2,1 

30 DATA 0,2,2.2,1,2,2,1,1,1 

40 DATA 1,1,1,2.2,1,2,1,0,0 

50 DATA 99 

And then saved by typing the conmand SAVE "DATA" and a carriage return. 
Several different data files can be produced if needed. 

The final program is loaded in two parts by typing the comiands: 

LOAD "PROGRAM" and a carriage return and then MERGE "DATA" and a carriage 

return. The final program appears as follows: 

10 REM LIVE DATA 

20 DATA 1,1,1,2,2.1,0,1,2,1 

30 DATA 0,2,2,2,1,2,2,1,1,1 

40 DATA 1,1,1,2,2,1,2.1,0,0 

50 DATA 99 

1000 REM PROCESS SERVEY MODULE. 

1010 T=1 :REM IN IT TOTAL COUNTER 

1020 REM VALID DATA IS 0=NO OPINION.! =YES,2=N0,99=END OF DATA. 

1025 READ C 

1030 IF C=0 THEN T1=T1+1 

1040 IF C=1 THEN T2=T2+1 

1050 IF C=3 THEN T3=T3+1 

1060 IF C=99 THEN T=T-1 :GOTO 5000 

1070 IF C<0 OR C>2 AND C<>99 THEN PRiriT " ITEM" ;T ; "NOT VALID" 

1080 T=T+1 

1090 GOTO 1025 
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5000 REM PRINT MODULE 

5010 OPEN 1 "*P" ERROR 5200 

5020 A$="ZZ9":B$="VZ9" 

5030 Pl=n/T:P2=T2/T:P3=T3/T 

5040 IF P1+P2+P3O100 THEN PRINT"PERCENT ERROR": STOP 

5050 PUT 1 TAB{60);"NO" 

5060 PUT 1 TAB(10);"RESPONSES";TAB(25);"YES %" •,TAB(46)"N0 %"; 

5070 PUT 1 TAB(60) "OPINION %" 

5080 PUT 1 REPEATS ("^",72) 

5090 PUT 1 TAB(12);FMT(T,A$);TAB(25);FMT(T1,A$);TAB(30);FMT(P1,BS); 

5100 PUT 1 TAB(45);FMT(T2,A$);TAB(51);FMT(P2,B$);TAB(60);FMT(T3,A$); 

5110 PUT 1 TAB{69);FMT(P3,BS) 

5120 PUT 1 REPEAT$("-",72) 

5130 CLOSEl: STOP 

5200 PRINT ERRS :INPUT"CONTINUE",C$: GOTO 5020 

5.4 THE DELETE COMMAND 

Groups of program lines may be eliminated from the current program buffer 
by using the DELETE coirmand. There are four forms of this command. 

Type DELETE X-Y to eliminate the lines numbered X through Y. Line number 

Y must be greater than line number X. If either line X or line Y or both 

are not 1n the current program buffer a LINE NOT FOUND message will be displayed 

and nothing will be deleted. 

Type DELETE X- to eliminate line X through the last line in the current 
program buffer. If line X is not in the buffer a LINE NOT FOUND message 
will be displayed and nothing will be deleted. 

Type DELETE -Y to eliminate the first line through line Y in the current 
program buffer. If line Y is not in the buffer a LINE NOT FOUND message will 
be displayed and nothing will be deleted. 

Type DELETE to eliminate the entire contents of the current program buffer. 
The buffer will be set to empty and a new program may be entered. 

5.5 THE LIST COMMAND 

All or part of the program in the current program buffer can be listed 
on the terminal display device by using the LIST Comnand. There are four 
forms of this command. 

Type LIST X-Y to display the lines numbered X through Y. Line number Y must 
be greater than line number X. If either line X or Y are not in the current 
program buffer the first present line number greater than X or Y will be used 
instead. 

Type LIST X- to display the lines from line X through the last line in the 
current program buffer. If line X is not in the current program buffer the 
first present line number greater than X will be used instead. 
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Type LIST -Y to display the first line through line number Y in the current 
program buffer. If line Y is not in the current program buffer the first 
present line number greater than Y will be used instead. 

Type LIST to display the entire content of the current program buffer. 

5.6 THE SAVE COMMAND 

A program in the current program buffer can be stored on disk for later 
retrieval by using the SAVE comroand. 

SAVE "N: unit number: name of file" is the general form of the conmand. 

The word SAVE and the quotation marks and the name of file must always be 
present. The name of file may be from 1 to 10 characters long. The characters 
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which are legal in a file name are the letters A through Z, the digits d 
through 9, and ten special characters including conuia (,), dash (-), 
period (.), slash (/) , semi-colon (;), less than (<) , equal (") , greater 
than (» , question mark (?) and at sign ((?) . 

Bie N: la optional. If it is not included in the connaand the existing 
file with the specified name on the specified unit will be overwritten 
and replaced by the program in the program buffer. If no such file exists 
the message FILE NOT FOUND will be output. . However, if the N: is included 
in the SAVE command then a new file will be created with the designated 
name on the designated unit. If N: Is used and the file already exists 
on the specified unit the message DUPLICATE NAME will be output. 

The unit number: is also optional. When present it consists of a single 
digit from (^ to 3 followed by the colon (:). It represents the address 
of the disk unit on which the specified file is to be replaced or created. 
If no unit number Is specified in the SAVE conmand, unit is assumed. 

5.7 THE LOAD COMMAND 

A previously stored program can be retrieved from disk and placed in the 
current program buffer by using the LOAD coimnand. 

LOAD "unit number: name of file" la the general form of the command. 

The word LOAD and the quotation marks and the name of file inist always be 
present. The name of file may be from 1 to 10 characters and lay use the 
letters A-Z, the digits 0-9 and the special characters (,), (-), (,), (/), 

(;), «), (-), (?),C@),(»- 

The unit nuiriber: is optional. If it is used It must consist of a single 
digit from to 3 followed by a colon (:). It designates the address of 
the disk unit on which the specified file is to be found. If no unit nximber 
Is specified, unit Is assumed. 

If the filename specified in a LOAD command is not present on the specified 
unit the message FILE NOT FOUND will be output. When a program file is 
successfully loaded it replaces the contents of the current program buffer 
and all data associated with the last program In the buffer is lost. If 
the filename specified in the LOAD command is a data file (see section 5.21) 
which cannot be properly placed In the program buffer, the message NOT A 
LOAD FILE will be output. 

5.8 THE DISFLAY COMMAHD 

The names of all files ^tch are presently stored on a diskette are recorded 
in a special file on that diskette. This special file is known as the 
diskette directory and its name is always DH. The names currently recorded 
in a diskette directory can be output to the terminal display by using the 
DISFLAY consnand. 

DISPLAY "unit number: DIB." is the general form of the command. 
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The word DISPLAY and the quotation marks and the name DIR must be "resent . 
The unit number: is optional. If it is not present unit <b is assumed. If 
it is used it must consist of a single digit from <i to 3 followed by a colon (:) 
It designates the address of the disk unit whose directory is to be displayed. 

The DISPLAY coinnand outputs the filenames five to a line. The first name 
shown should always be DIR. On disks where it is present the second name 
shown should always be BASIC. 

If the diskette in the specified unit does not contain a valid directory file 
a PERM L/0 ERR message will result because the disk cannot be accessed by 

the BASIC system. 

5.9 THE SCRATCH COMMAND 

A file that is stored on disk may be eliminated by using the SCRATCH command. 

SCRATCH "unit number: name of file" is the general form of the command. 

The word SCRATCH and the quotation marks and the name of file must always 
be present. The name of file may consist of 1 to 10 characters. Including 
the letters A-Z, the digits 9-9 and the special characters (,), (-), (.), 

(■/), (;). «), (=), (». {?), m. 

Tb.& unit number: is optional. If it is used it must consist of a single 
digit from to 3 followed by a colon (:), It designates the address of 
the disk unit from which- the specified file is to be eliminated. If no 
unit number is specified, unit will be assumed. If the specified file 
on the specified unit does not exist the message FILE NOT FOUND will be 
output. 

When a file is SCRATCHed the storage space unused by that file is automatically 

freed and made available for reallocation. 

5 . 10 THE RUN COMMAMD 

A BASIC program must be in the current program buffer in order to be 
executed by the interpreter. This may be accomplished by typing in the 
program from the input terminal or by using the LOAD command. Once a 
program is in the current program buffer it may be executed by using the 
RIM command, 

RUN is the form of the command. 

When the RUN command is entered, the interpreter resets all disk files to 
"closed", and frees all memory space previously allocated Co variables from 
the last program run. It then begins execution of the program with the 
first program line in the buffer and proceeds to execute program lines in 
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ascending order of line nuiaber. This sequence is altered only when 
particular program statements deliberately change the sequence by trans- 
ferring control. Each program line is only executed when execution 
control reaches that line; it is executed each time that this occurs. 
Execution is halted when an END or STOP statement is encountered or when 
execution control processes the last line In the current program buffer 
and it does not alter the control sequence. At this point the interpreter 
displays the i^ssage READY and waits for a line to be entered. 

5.11 mrSRRUPTING A RimNIHG PROGSAM 

The execution of a program may be interrupted prior to completion by 
holding down the CONTROL key and typing C at the input terminal. The 
interpreter will respond by displaying the message INTERRUPT followed 
by the message READY. 

The interruption generally occurs after the end of lAatever program line 
was being executed ^en the CONTROL C was entered. In the case of the 
input statement and wheneirer characters are being output, the interrupt 
will occur inmed la te ly . Under these circumstances the rejoinder of the 
input or outout will be lost if a continue is attempted (see section 5.12). 

When program execution is interrupted, the value of all program variables 
remain as last assigned. Any open disk files remain open with file pointers 
current. Variables nay be examined by using immediate PRINT statements and 
may be altered with immediate assignment statements. These are frequently 
used aids in debugging programs. However, if the program in the current 
program buffer is modified (lines deleted, inserted, or changed) then all 
variable and file information from the interrupted program is lost and the 
program can no longer be continued. 



5.12 CONTINUING AN INTERRUPTED PROGRAM 

If an executing program has been interrupted by the CONTROL C procedure 
and no changes have been made to the current program buffer, then the 
execution of the program may be continued by using the CONT cosmand. 

CONT is the form of the coimaand. 

When the CONT command is entered program execution is resumed at the point 
in the execution control sequence following the last program line executed. 
If continuation is not possible because no program has been interrupted or 
because the current program buffer has been altered, the message NOTHING 
TO RETURN TO will be displayed. 
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5.13 PROGRAM TRACING COMMANDS 

Often, when developing a new program, it is useful to be able to follow 
the execution on a line by line basis. This capability is provided in ^ 
the Micropolis BASIC system through the use of the FLOW and NOFLOW commands. 

FLOW is the form of the command which enables this program line tracing 
capability. When the FLOW trace capability is enabled and the RUN command 
is entered the interpreter displays each urogram line inmediately before 
it is executed. The FLOW trace remains enabled after the end of a program 
execution. It must be specifically disabled. 

NOFLOW is the form of the command which disables the program line tracing 
capability. 

5 . 14 BASIC SYSTEM ERROR HANDLING 

Whenever the BASIC interpreter attempts Co execute an inmediate line 
which has just been entered or the next program line during program 
execution, it is possible that an error condition may arise. If this 
occurs the interpreter triee to indicate the problem by displaying an 
appropriate error message at the terminal. 

If the line in error is an immediate line then the error message will 
be directly followed by the message READY. All or part of the erroneous 
line may not have been executed. 

If the line in error is a program line, the line number and text of the 
erroneous line are displayed after the error message and before the READY 
message. All or part of the erroneous program line may not have been 
executed. Program execution is not continuable after an error. 

Appendix A specifies the error messages which may be printed by BASIC 
and their probable causes. 

5.15 THE BASIC CHARACTER SET ' , , 

BASIC recognizes all printing ASCII characters except the SHIFT (5F HEX) 
backspace character and the RUB OUT (7F HEX) character. However, lower case 
symbols may only be used in REM statements and in literal strings. The 
character set, along with the decimal, hexadecimal and octal values of the 
corresponding ASCII codes are listed in table 5.1. 
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5. 16' BASIC DATA 

BASIC programs operate on two types of data: Numeric and String. Numeric data 
includes integers and real (floating point) numbers. Character string data 
items consist of a sequence of characters chosen from the BASIC character set. 
This includes letters, numbers, special characters and blanks, A data item 
may be a constant which has an unchanging value, or a variable which may assume 
different values during the execution of a program. A variable may be either 
simple or grouped with other variables of like data type into a structure 
called an array, and referenced as a n»mber of the array. 

5.16.1 CONSTANTS 

A constant is an unvarying value. It is expressed as its actual value. A 

constant may be a numeric value, or a character string value. 

5,16.1.1 NUMERIC CONSTANTS 

Numeric constants may he integers or real numbers. 

An tnceger is a positive or negative whole number which may be defined 
as a decimal number or in any number base (radix) up to 36. The format 
of an integer may be: 

Integer format: -nn. ...n Example: -93784 

Radix" format: -xxRnn. ...n Example: -16R7B2 

Where (-) is an optional sign, xx is the number base, R indicates radix 
format, and nn....a is the number expressed with the digits i-9 and the 
letters A-Z (for radix format). The range of an integer specified in 
decimal format is 1-5E (2*ISIZE) to 5E (2*ISIZE) , See SIZES statement 
for definition of ISIZS, The maximum value of an integer specified in 
radix format is 65535. A DIGIT BEYOND RADIX error occurs if a digit or 
letter is used that is invalid for the radix specified. 

A real number is a positive or negative number which includes a decimal 
point and fractional part or a number expressed in scientific notation. 
The formats of a real number may be: 

Real format: -nn. . . .n.nn. . . Example: -2.577 

Scientific format: -nn.,.aE-xx Example: 257E-4 

-nn, . ,n.nn. . .E-xx Example: -12.231E14 

Where nn...n-nn... represents the number expressed using the digits 0-9 
and a decimal point; an optional minus sign (-) denotes a negative number 
or exponent, E specifies scientific notation and xx renresents the 
exponent expressed with the digits 0-9. 

The range of a real number is lE-61 to (1E62)-1. 
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lASIC CHAHAGTSl SET IN OTLLATIHG SEQUSICS 



CHAS DECIMAL EM OCTAi 



CHAB DSCIMAl HS OCTAI 



(space) 


32 


20 


040 


% 


64 


40 


100 


f 


33 


21 


041 


A 


55 


41 


101 


m 


34 


22 


042 


3 


66 


42 


102 


M 


35 


23 


043 


C 


67 


43 


103 


m 


36 


24 


044 


13 


eB 


44 


104 


"K 


37 


25 


045 


1 


69 


45 


105 


1. 


38 


26 


046 


7 


70 


46 


lOS 


• 


39 


Z7 


047 


5 


71 


47 


107 


{ 


40 


28 


050 


H 


72 


43 


110 


% 


41 


29 


051 


I 


73 


49 


111 


• 


42 


2A 


052 


J 


74 


4A 


112 


+ 


43 


2B 


053 


5 


75 


41 


113 


f 


44 


2C 


054 


L 


76 


40 


114 


- 


45 


21 


055 


!f 


77 


4!) 


115 


• 


4S 


23 


056 


H 


78 


435 


llo 


/ 


47 


2? 


057 





79 


4? 


117 





43 


30 


060 


p 


30 


50 


120 


I 


m 


31- ■ 


051 


Q 


81 


51 


121 


2 


50 


32 


062 


■R 


92 


52 


122 


3 


51 


33 


063 


S 


33 


53 


123 


4 


52 


34 


064 


T 


34 


54 


124 


5 


53 


35 


065 


7 


35 


55 


125 


S 


54 


36 


065 


T 


as 


56 


126 


7 


55 


37 


067 


¥ 


37 


57 


127 


S 


56 


38 


070 


X 


88 


58 


130 


9 


57 


m 


071 


T 


39 


S3 


131 




58 


3A 


072 


Z 


90 


5A 


132 




59 


31 


073 


I 


91 


5B 


133 


< 


60 


3G 


074 


\ 


92 


5C 


134 


a> 


51 


ZD 


075 


1 


93 


5B 


135 


> 


62 


31 


076 


t 


94 


51 


136 


? 


63 


3? 


077 


** 


96 


5? 


137 



Table 5.1 Standard Collating Sequence 
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5.16.1.2 STRING CONSTANTS 

A character string is a sequence of valid BASIC characters. Entered 
as a constant, a string must be enclosed in quotes (") . Quotes 
within a string must be doubled (the constant " is entered as " " " " ). 
The length of a string is the number of characters. The maximum 
length of all character strings within a program is set by the SIZES 
statement. 

5.16.2 VARIABLES 

Variables may be integer, real, or string. The amount of memory used 
for each of the 3 types can be defined in a SIZES statement before 
execution of a BASIC program. ISIZE defines the memory space for 
integers; RSIZE for real variables; and SSIZE for character strings. 

5.16.2.1 IFTEGER VARIABLES 

Integer variables are designated by any letter followed by a percent 
sign (%). 

The range of an integer is from 1-5E(2*ISIZE) to 5E(2*ISIZE) . 
The internal format is 2 BCD digits per byte stored in tens complement. 
If an attempt is made to store a number that exceeds the range a 
CONVERSION error occurs. 

5.16.2.2 REAL VARIABLES 

Real variables are indicated by any letter {not enclosed in quotes) 
or a letter followed by a digit. The range of a real is lE-61 to 
(1E62)-1. The precision or level of accuracy is 2(RSIZE-1) decimal 
digits . 

The Internal Storage Format Is: 

Byte 1: 1 bit sign and 7 bit exponent (excess 64) 

Byte 2 thru RSIZE: 2 BCD digits per byte. 

5.16.2.3 STRItTG VARIABLES 

A string variable is designated by a letter followed by a dollar 
sign (5). String variables may have a length of un to 250 characters. 
The default value of maximum string length is defined by the SSIZE 
parameter of the SIZES statement. The maximum SIZE of any particular 
string may be declared in a DIM statement, which supercedes the 
SIZES statement. If a string which is longer than the maximum length 
is assigned to a variable, it will be truncated on the right. 

The internal format of a string variable is: 
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Byte 1: Maxiimia string length 
Byte 2: Current string length 

Byte 3 thrv N: Any character, 1 character per byte 
(N« 2+ Maxiinum string length found in Byte 1) 

5.16.2.4 cowrmsiom 

Automatic conversion between integer and real data types is pro- 
vided which allows mixed-mode arithmetic. A real value is con- 
verted to an integer by truncating the fractional part while 
preserving the sign of the number. 



Conversion between string and numeric data types is provided by 
the STR$, VAL, FMT, CHAil$, and ASC functions. See section 5.18.1.2 
for description of these functions. 

5.16.2.5 AREAYS 

Numeric and character string data may be stored in memory as 
arrays. An array is a set of variables of one data type (numeric 
or character) Identified by a single '\rariable name. A nujjffiric 
array is denoted by a single letter or a single letter followed 
fay a percent sign (1) and nay have 1 to 4 dimensions. A string 
array is denoted by a single letter followed by a dollar sign ($) 
and taay have 1 to 3 dimensions. Both types of array are zero 
indexed. An array must be declared in a DIM statement which 
defines the number of dimensions and the index range in each 
dimension. An array indexing error occurs if an attempt is made 
to reference an element of an array which has not been defined in 
a DIM statement, 

A one dimensional array is a simple linear list in which the 
elements of the array are stored sequentially in memory. For 
example, an array A which has a dimension of 4 is stored; 

A (0) 

A (1) 

A (2) 

A (3) 

A (4) 

An element of a one dimensional array is referenced by the array 
name and by the index of the element within the array, enclosed in 
parentheses. Bxe 4th element of array A in the above example is 
A (3). The index may be specified by a constant, as in this 
example, a numeric variable, or a numeric expression. 
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A two dimensional array is conceptualized as a table organized 
by rows and colunms. An array B dimensioned as B (3,2) would 
be represented as: 

G C C 



L L L 

12 



ROW 

ROW 1 

ROW 2 

ROW 3 



















^ 









Array B(3.2) 



An element of a 2 dimensional array is referenced by the array 
name and the row and column indices. The shaded element in the 
above illustration is referred to as B(2,2), where the first 
index is the row index and the second is the column index. 

The elements of a 2 dimensional array are stored sequentially in 
memory in column major order, that is column by column. The 
elements of the array B would be stored: 



B 


(0,0) 


B 


(1.0) 


B 


(2.0) 


B 


(3,0) 


B 


(0,1) 


B 


(1.1) 


B 


(2,1) 


B 


(3,1) 


B 


(0.2) 


B 


(1,2) 


B 


(2,2) 


B 


(3,2) 



As with one~dlmensional arrays, the row and coltimn indices may be 
specified by a constant, a numeric variable or a numeric expression. 

3 and 4 dimensional arrays are extensions of the two dimensional 
concept. An element of one of those arrays Is referenced by the 
array name and the appropriate number of indices. 

5.16.3 OUTPUT FORMATS 

A numeric data item is converted to a string when it is output to 
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the terminal. Unless the output format is explicitly specified 
by use of the FMT function, a numeric value will be output in 
one of three default formats according to the following rules: 

1) The negative sign (if present) precedes the nunier 

2) A space is output in place of a positive sign 

3) A space is output following the number. 

4) A number is either a whole number or a decimal 
number. A whole number is a number without a 
fractional part. A decimal number is a number 
with a whole and a fractional part. 

5) The output formats are: Whole, Decimal and Scientific. 

Whole: (-)xxxxxxxtf 

Decimal : (-)xxx ... x.xxxH 

Scientific: (-)n.xxxxx E(-) TTli 

(-) = minus sign if negative, blank if positive 

X « digit position 

n =" one non-zero digit 

E = signifies exponent 

TT = exponent 

U - blank 

6) nie value of an integer variable is output in whole fornat. 

7) A constant or the value of a real variable is output as 
follows: 

a) If the constant or value Is a whole number 
having less than or equal the number of digits 
specified by RSIZE, then whole format is used. 

b) If the constant or value is a decimal number greater 
than or equal to .1 and having less than or equal the 
number of digits specified by ESIZl, then decimal 
format is used. 

c) Otherwise, scientific format is used. 
String data is output without modification. 

The maximum output line length is 250 characters. If an attempt 
is made to output a line longer than the maximum length, i.e., by 
trying to output 2 strings of 250 characters with the same nrint 
statement. The characters in excess of 250 are truncated and 
the message "WARNING —TRUNCATED OUTPUT" is output. 
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5.17 BASIC OPERATORS 

Operators are s3fmbols which specify operations to be performed upon data 
items. BASIC recognizes 4 classes of operations: 

Numeric(arithmetic) ; String; Relational; and Logical. 

5.17.1 Numeric Operators 

Numeric operators specify arithmetic operations to be oerforraed 
upon numeric data items and numeric function references. A numeric 
data item may be a constant, a simple numeric variable or a numeric 
array element. Numeric operators are classified as binary operators 
which perform operations with 2 data items, and unary operators which 
perform operations upon single data items. 

The binary operators are listed below: 



Symbol Operation 

^ Exponentiation 

/ Division 

* Multiplication 

\ Integer Division (XVY = Int(X/Y)) 

._ Subtraction 
+ Addition 

The unary operators are listed below: 

Symbol Operation 

Negation 
+ No effect 

The "+" symbol is recognized as a unary operator to allow constructs 
such as A" +7 and A» +B to be syntactically correct although the "+" 
has no effect. 

5.17.2 String Operators 

One operator is recognized for string data items: concatenation. 
A string data item may be a string constant, string variable or 
string array element, or a string function reference. 

Symbol Operation 

+ Concatenation 
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The "+" operator yields a string composed of the characters in the 
string data item to the left of the operator followed by the char- 
acters in the string data item to the right of the operator, 

EXAMPLE: If A$ = "ABCD" and B$ = "EFGH" the operation A$ + B$ 
yields the string "ABCDEFGH" 

5.17.3 Relational Operators 

Relational operators allow the comparison of the values of numeric 

or string data items. 

The relational operators are listed below; 



Symbol 


Meaning 


< 


Less Than 


> 


Greater Than 




Equal to 


<= 


Less than or equal to 


>- 


Greater than or equal to 


<> 


Not equal to 



A relational operator is used in an expression of the form (Data Item 1 
operator Data Item 2) which yields a single value as follows: The 
values of the two data items are compared. Based upon this comparison 
if the expression is true, the value "true" (1) is returned. If the 
expression is false, the value "false" (0) is returned. 

EXAMPLE: If A=l and B=2 then 

A^ Yields a value of 1 
A=B Yields a value of 

"Hie data items compared must both be the same data type (numeric or 
string) or a type error results. 

String comparison is performed as follows: Starting from the leftmost 
character, two strings are compared character-by-character until there 
is a mis-match or the end of one of the strings is reached. If there 
is a mis-match, the string containing the character which is higher in 
the collating sequence is considered "greater" than the other string. 
If the end of one of the strings is reached without a mis-match and 
the strings are not of the same length then the longer string is 
"greater". If the end of one string is reached and the strings are 
of the same length then the strings are "equal". 
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5.17.^ Logical Operators 

The relatiooal operators as described in section 5.17.3 return a 
value of "true" or "false", lliis type of value is referred to as 
a boolean value and is represented in Micropolis BASIC as an integer. 
Truth or falsity is determined by converting the integer to a 16 bit 
binary nunAer. If the least significant bit of the binary number is 
then the value is false, else the value is true. Logical operators 
specify operations to be performed with boolean values as described 
below: 

Binary Logical Operators 

■(■■■■■■■■■■■■■■■■■•■^^ 



Operator 
AND 



Expression 
?AL 1 AND VAL 2 



Truth Table 



VAL 1 


VAL 2 


RESULT 


True 


True 


True 


True 


False 


Fa]se 


False 


True 


False 


Fa'se 


False 


False 



Operator 
OR 



Exnression 



VAL I OR VAL 2 



Truth Table 



VAL 1 VAL 2 RESULT 



True 


True 


True 


True 


False 


True 


False 


True 


True 


False 


False 


False 



Operator 



NOT 



Unary Logical Operators 
Expression Truth Table 

NOT VAL 



VAL 


RESULT 


True False 


False 


True 



The primary function of the logical operators is to allow the 
formation of comnlex exnressions which evaluate to a single vaJue of 



EXAMPLE: A<=B AND G=0 
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A secondary function Is nrovided by the 16 bit implementation of 
Boolean values. The logical onerators perform the above defined 
funct'ons across the full 16 bits. This allows you to perform the 
AND, OR and Complement (NOT) functions in the same manner as the 
elementary 8080 instructions. The utility of this feature is illus- 
trated in the following examrle which is a serial I/O handler for 
an IMSAI SIO board. 

8000 REM INPUT ROUTIIi: - RETURNS CHAR IN A 

8100 A = IN <3) AND 2: IF A -0 GOTO 8100 : .' WAIT INHJT READY 

8200 A ■-= IN (2) AND 16R7F: RETURN:.' MASK PARITY AND RETURN 

8300 REM OUTPUT CHARACTER IN A 

8400 B- IN (3) AI^Dl: IF B-0 GOTO 8400:.' WAIT OUTPUT READY 

8500 0UT(2) = A: RETURN :.' OUTPUT AND RETURN 

NOTE: This example will not work for I/O to the terminal device. 
The BASIC interpreter checks for input from the terminal 
between execution of BASIC statements and will gobble any 
character received unless it is a CTL/C, 

5.18 BASIC FUNCTIONS 

Functions are included in the BASIC language to provide commonly required 

computations. A function reference consists of the nan«, followed by its 

arguments. The arguments are enclosed in parenthesis and separated from 
each other by commas. 

A function returns a single value. 

BASIC recognizes two types of functions: Intrinsic functions which are 
built into BASIC; and user defined functions. 

5,18.1 Intrinsic Functions 

Intrinsic functions may be classified as numeric, string, special 
and file. The functions relating to files are discussed in the file 
I/O section- 

5.18.1,1 Numeric Functions 

The numeric functions provide most of the coninonly used trigonometric 
and math functions. The math package computes these functions with up 
to 20 digits of precision, which requires RSIZE to be set less than or 
equal to 10, Attempting to use the math functions with RSIZE greater 
than 10 will cause a PRECISION ERROR. TJie numeric functions are detailed 
in table 5.2. 
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Table 5.2 



OTHER IC FUNCTIONS 



Function 
Reference 


Value 


ABS(x) 


The absolute value of x, where x is a 
numeric expression. 


ATN(x) 


The arctangent of x, where x is a 
numeric exnression. Returns value in the 
range -It/ 2 toTT/Z. 


COS(x) 


The cosine of x, where x is a numeric 
ex-ression in radians. 


EXP(x) 


The value of e raised to the power x, 
where x is a numeric expression. 


FIX(x) 


The whole number part of x with any frac- 
tional part truncated and the sign preserve4 
where x is a numeric expression. 


FRAC(x) 


The fractional part of x with the sign 
preserved, tshere x is a numeric expression. 


INT(x) . 


The greatest integer not greater than x, 
where x is a numeric expression. 


IJI(x) 


The logarithm of x to the base e, where 
X is a numeric expression with a value 
greater than 0. 


LOG(x) 


The logarithm of x"to base 10, where x 
is a numeric expression with a value 
greater than 0. 


MX(x,y) 


The greater value, x or y, where both x 
and f are numeric expressions. 


MTN-Cx.y) 


The lesser value, x or y, where both x 
and y are numeric expressions. 


MDD(x,y) 


X modulo y which is equal to x-(y*IFr(x/y)) . 
Both X and y must be numeric exnressions. 
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Table 5. 2 



(cont) 



Function 
Reference 



Value 



RND(x) 



Generates a pseudo random number between 

and 1. The argument x is a numeric 

expression which controls the number generated 

as follows: 

If X is non zero, RND generates a number 

using X as the seed. If x=0, the last 

random number generated is used as the seed. 

Repeatedly calling RND with x=0 generates 

a sequence of pseudo random numbers. 



SGN(x) 



+1 if the sign of x is positive, -1 if the 
sign of X is negative, if x is 0. 



SIN(x) 



The sine of x where x is a numeric exp- 
ression in radians. 



SQR(x) 



The positive square root of x, where x is 
a positive .nunffiric expression. 



TAN(x) 



The tangent of x, where x is a numeric 
expression in radians. 
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5. 18. 1-2 String Functions 

String functions are provided to compare strings, manipulate substrings 
and to convert between numeric and string data types. The string functions 
are detailed in table 5.3. 



Table 5.3. 



STRING FUNCTIONS 



Function 
Reference 



Value 



ASC(s$) 



The ASCII code of the first character 
in string s$. Returns a numeric value 



CHAR$(x) 



Returns the character whose ASCII code 
is X 



FMr(K,y$) 



Returns a string consisting of the value 
X formatted by the picture contained in 
string y$. The argument y$ can be any 
expression evaluating to a string. Each 
character In the string (except a V) 
represents one character in the result 
string. The following characters are 
used to format Che digits of a number; 

9-- A digit position of the number 
leading zeroes ate output as "0" 

Z-- A digit position. Leading zeroes 
are replaced by blanks. 

V-- Decimal point alignment. If V is 
not specified, Che decimal point 
is assumed to be at the far right 
resulting in truncation of the 
fractional part of the number. 

$-- A digit position. If more than 1 
$ appears in the string then the 
digit rosition closest to the leading 
non-zero digit of the numbercontalns 
a "$" and the leading zeroes are 
blanked. 

*•-- A digit nosition. Leading zeroes 
are replaced by asterisks. 

,-- A comma appearing before the leading 
digit is reolaced with a blank, 
asterisk or dollar sign according to 
the context. 

All other characters are output unchanged 
If the number is too large to fit in the 
format specif led, the entire string Is 
filled with question marks (?) . 
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Table 5.3 



(continued) 



Func t ion 
Reference 


Value 


INDEX (x$, y$) 


The position in string x$ of the first occurrence 

of string y$. If string y$ is not a substring of 
x$, then is returned. 


LEFT$ (x$, n) 


Returns n leftmost characters of x$. 


LEN (x$) 


Returns length of x$. ! 


MID$ (x$,n,y) 


Returns y characters from string x$ starting with 
character n. 


MAX (x$,y$) 


The greater, string x$ or string y$. See the 
collating sequence in Table 5.1. 


MIN (x$,y$) 


The lesser, string x$ or string y$. See the 
collating sequence in Table 5.1, 


REPEAT? (x$, n) 
1 


The character string with string x| repeated 

n number of times. 


RIGHT$ (x$, n) 


The n rightmost characters of string x$. 


STSi$ (n) 


Converts the number n to a string. 


VAL (x$) 


Converts the string x$ to a nunier. Bie contents 
of x$ may be numeric digits or a numeric expression. 
EXAMfLE: If A$ =■ "2+2", then VAL (A$)=4 


•VERIFY (x$, y$) 


Verifies that all characters in string x$ are. also 
in y$. Returns the position of the first character 
in x$ which is not found in y$. If all characters 
in x$ are in y$ returns 0. 
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5. 18-1. 3 Special Functions 

Micropolls BASIC provides several other functions which nertain 
neither to numbers nor strings. These Special functions are 
detailed in Table 5.4, 



Table 5.4 



SPECIAL FUNCTIONS 



Function 

Reference 


Value 


IN(x) 


Inputs a value from I/O port x. The 
value of X must be greater than and 
less than 236. 


PEEK(x) 


Returns the contents of memory 
location X. The value of x must be 
greater than and less than 65536. 


PGMSIZE 


Returns the size of the program 
currently occupying the program buffer 
in bytes. 


SPACELEFT 


Returns the amount of space left in 
the program buffer In bytes. 



5-18,2 User Defined Functions 

Micropolis BASIC provides the ability to define two tynes of functions: 
BASIC functions and assembly language functions. 

5.18.2.1 User Defined BASIC Functions 

BASIC allows the user to define functions which consist of BASIC 

expressions and which are referenced in the same manner as the 

intrinsic functions. A BASIC function is defined in a DEF statement 
which has the following form: 



DEF 



FN( letter) (parameter) = expression 



Function Optional 
Name Parameter 



Expression which provides 
the value of the function 
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The characteristics of a function definition are: 

1) Function Name — consists of the characters "FN" and one of 

the letters A-Z yielding up to 26 user-defined BASIC functions. 

2) Parameter--a function may optionally include a parameter which 
passes a value to the function when it is referenced. The 
parameter which appears in the function definition Is a "duumiy 
parameter". For example, consider the function defined by: 

10 DBF FNZ(X) = xfa+xfS+A+B 

The parameter X is a "dummy" In the sense that when the function 
is referenced, the value passed in the function reference is 
used in the place of "X". The narameter is only used in the 
definition to indicate the form of the exoression. However, the 
variables A and B are actual variable names. When the function is 
referenced, the current values of A and B are used in evaluating 
the expression. 

3) Express ion- -a function may be defined as either a string function 
or a numeric function by the form of the expression. Tlie ex- 
pression may be any BASIC expression ■jAich yields a single value 
of the appropriate data type. 

A function reference consists of the 3 character function name 

and the parameter (enclosed in parentheses) if a parameter is 
included in the function definition. A function reference yields 
a single value and can be used as a data item in any expression 
not restricted to constants. A small program using the above 
defined function is given below as an example: 

10 DEF FNA(X)=xt3+xi2-tA4B 
20 INPUT A,B,C 
30 P&INT FNA(C) 
40 GOTO 20 

READY 

RUN 

? 2,3,1 

7 
? 0,1,2 

13 

7 

INTERRUPT 
READY. 
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Below is an example of a string function. 



5 SIZES (5, 4, 80) 

10 DBF FNBCS$)=REPEAT$(S$,N5 

20 INPUT A$,N 

30 B$=FNB(A$)+"ISH'T THIS REPETITIVE?" 

40 PRINT B$ 

READY 

RUN 

? "AGAIN AND ",4 

AGAIN AND AGAIN AND AGAIN AND AGAIN AND ISN'T THIS REPETITIVE? 



READY 

See the "DEF FN" statement for more detailed information. 

5.18.2.2 Assembly Language Functions 

Micropolis BASIC allows the user to define Assembly Language 
"Functions" which provide linkage to assembly language subroutines. 
The linkage allows a BASIC program to pass from 1 to 4 arguments 
to an assembly language subroutine and provides for a result to be 
passed back to the basic program vAen the assembly language sub- 
routine returns control. 

An Assembly Language Function is defined as follows: 

DEF FA (letter)- expression 

The function name consists of the characters "FA" and one of the 
letters A-Z yielding uo to 26 assembly language functions. The 
expression is a numeric expression which specifies the memory address 
of Che subroutine entry point. 

An assembly language function reference consists of the 3 character 
nan» followed by a list of arguments enclosed in narentheses. 

Examples: 

100 A = FAA 

200 A$ =» FAB (B$, C$) 

Up to 4 arguments may be passed to an Assendsly Language Function 

and I result may be passed back as the velute of the function reference. 
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The arguments and result are passed through the following locations 
which define the subroutine linkage: 



LOCATION 



LABEL 



DESCRIPTION 



04BCH 


ARGl 


048 EH 


ARG2 


04C0H 


ARS3 


04C2H 


ARG4 


04C4H 


NARGS 


04C5H 


RSIZE 


04C6H 


ISIZE 


04C7H 


SSIZE 



Pointer to the first argument 
Pointer to the second argument 
Pointer to the third argument 
Pointer to the fourth argument 
Number of arguments passed 
Values of RSIZE, ISIZE 
and SSIZE as described 
in Section 5.20.26 



01A0H 



RESULT 



250 byte result buffer 



When an assembly language subroutine is referenced, the basic interpreter 
sets the pointers in the linkage table to point to the values of the 
arguments, indicates the number of arguments passed in NARGS, and calls the 
subroutine. When the subroutine returns, the interpreter expects to find 
the value returned by the subroutine, if any, in the result buffer. 

The format of the arguments pointed to by ARGl -4 and of the result returned 
is: 

BYTE - Type Indicator 

1 - Real 

2 - Integer 

3 - String 

BYTE 1-N- Refer to Section 5.16.2 "Variables" for the 

internal storage fonnat for each variable type. 
The length of each variable type is specified 
by RSIZE, ISIZE and SSIZE. 

The general procedure for using assembly language subroutines is as follows: 

1) Load BASIC from MDOS or directly from a BASIC only SYSTEM DISK. 

2) Set the memory space used by BASIC using the MEMEMD statement 
to reserve space above BASIC for your subroutine. 

3) Load the subroutine using the LOAD conmand. Execution of an 
object file load within a program is allowed. 

4) Define the name and entry point of the subroutine with the 
DEF FA Statement. The subroutine may now be used. 
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The assembly language program example on the following oages demonstrates 
most of the principles involved in passing arguments and returning results. 
It was created by using the assembly language development tools of the 
MDOS system. The source program was entered with LINEEDIT and then assembled 
with ASSM to produce an object file named CONCAT which can be loaded by 
BASIC. 

The CONCAT subroutine expects two string arguments to be passed and returns 
a string which is composed of the second argument concatenated with the first 
argument. If only one argument is passed, the result string is "argument 
error". If both arguments are not strings, the string returned is "type 
error" . 

Note: This example Is not complete - a proper subroutine of this type 
would have to handle the special cases of null strings and checking to see 
if the maximum string length has been exceeded, etc. 
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0020 * * 

0000 * ASSi^'BLY lAHQlJklf * 

3000 * 5U?PnUTlNE LINKAGE * 

0000 * lEMC 1978 * 

^200 . * * 

^00 2 **i:!*«>!f3;t*j>:j!!*3!!3f:*1^3!:*«ft*«***=!:J!'** ******* 

2002 - 

2.002' * 

302 a * 

000Z 21A0 RESULT EC'J 1A3H 

3ZZ2 04EC AHGl ?5'J 4:BCH 

4200 04EE ARG2 ECU AFGl+2 

^0ev; 34C0 ahg? eq'J aegi+4 

d200 04C2 AIG4 E3U ARGl+6 

4<i03 04C4 KAP.GS iDU ABGl-a 

£^000 04C5 HSIZl EQTJ AEG 1 + 9 

0000 04C6 ISIZE ECU ABGl+10 

0030 04C7 SSIZE EQO AF.Gl + 11 
0002 * 

00 00 * 

000 ■:e CBG 5240H 

6040 " 

6040 * T^'IS TEMC ACCEPTS TWO AIGjMEMTS 

t040 * WHICP ABE STHINGS AND RErjB'^f 

S240 * AHGl CONCATENATED WITH ARC?. 

6040 * 

C040 * 

6040 ZA C4 04 NilCK LEA NAiGS JCHECK ?0H T¥0 

5043 5E 82 C?I 2 J ARGUMENTS . 

604? C2 ar. 60 , JNZ N3EER ; IF NOT TWO - IE50P, 

604£ 2A 3C 04 TYPCK LHlD ARGl ;iL?E, GHECS TYPE CF 

604B 71 KCV A..^ ;AEG1. IT MUST 

604C FE 22 C?I 3 " ; BE A STIING. 

604£ C2 87 60 JNZ TYPEP.B JIJ NOT - EHP.OH , 

6051 2A BE 04 LELD AEG2 I ELSE, CHECK ARG? 

6054 7E f;0¥ A.K JIT ALSO KUST 

S05£ FE 03 CPI 3 J BI A STPING. 

5257 C2 e? 60 JNZ TYPEIE 5 IF NOT - ERRCE. 



e.'^'SA 



60 5 A 

O^SA-ll A3 01 

6051. 2E 03 

60 5 J 12 

6360 13 

5051 13 

5062 13 

6063 A? 

60 64 47 

6065 2A BC 04 

60 68 CD 79 60 ".^STP 

606B 2A BI 04 

60 61 CD 79 60 

6071 78 

6072 32 Al 01 

6075 32 A2 01 

6076 CS 



* 

* 3CTH ABGU?1ENTS ARE VALID STRINGS 



LXI 


D, RESULT 


J SI TUP RETURN 


^:vi 


A, 3 


fPARA^:ITER A? A 


ST AX 


D 


; STRING TYPE. 


I.^X 


D 


;SSIP OVER 


IKX 


D 


; LENGTH FOR 


INI 


D 


;now 


XRH 


A 


JZERO LENGTH 


MO 7 


1,A 


; COUNTER. 


LHLD 


AEGl 


;MCVE FIRST 


CALL 


XOVE 


JAlGUf'.EN'T TO RESUL.T 


LHLD 


APG2 


;M0?E SECOND 


CALL 


^'CVE 


JAGPUFENT TO RESULT 


y.oi 


A.B 


;get length count 


?TA 


SESULT + 1 


;PUT COUNT INTO 


ETA 


EESULT^2 


ibesult. 


HIT ■ 




iDONE, RETURN TO BASIC 
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60 ?9 

£079 
60 7S 
60 79 
6Z79 
6279 
6079 
63 7A 
6073 
507G 
607D 
62 71 
6075 
6080 
6361 
6062 
60 S3 
6086 
6297 

62 87 
6287 
60 £ A 
60eD 

63 oE 
6090 
55293 
60 55 
62S5 
6297 
6-2 9B 
6099 
62 9A 
6391 
6e9£ 
629£ 

62 91 
60 9E 

63 A 1 
6.JA4 
62A7 
60 A A 
e0Ai 
60A3 
62 A E 
6011 
6034 
62B7 
60BA 
601 C 
63BC 



23 
23 
4E 
23 
75 
12 
13 
23 
04 

er 

C2 
C9 



21 
C3 

21 
11 

3i 
12 
13 
13 
13 
A? 
47 



00 
54 
45 

52 

00 

41 

4i 
4F 



7D 60 



91 60 
90 60 

AS 60 
A0 01 
03 



68 60 



00 0A 

59 50 
20 45 

52 41 



00 0E 

52 47 
4D 45 

54 20 

52 52 
52 



* MOTE AHGUMINTS fO HtSUIf . 

* HL RIGISTIES HAS AHGGHINT 

* DE IIGISTERS HAS POSITION 

* 1 IIGISTEI IS COUNT 



ADDRESS. 
IM RESULT. 



mn 



MOV SI 



* 

TYPEHR 

NBBEl 
EMSG 



IMX 
INX 
HO 7 
INX 

MO 7 

SIAX 

INX 

INX 

INE 

DCR 

JMZ 

RET 



LXI 
JK? 

LXI 

JyA i 

MVI 

STAX 

INX 

INX 

INX 

XRA 

KCV 

JH? 



* EHROH 



NlPMSa 



H 

i 

CM 

a 

A,M 
D 
D 
H 

B 
C 

MOVIl 



H.TYPMSG 
EMSG 

H.NIHMSG 

D.HESTILT 
A, 3 

D 
D 
D 

A 

B t A. 

MSTS 



JSSIP TTPI 
ISSIP MAX LSNGTI 
IGIT LENGTH OF STRING 

1 3 IT CKARACTEl 

i put it into result 
;next 

I COUNT +1 
; LENGTH -1 
UOCP TILL DONE 
JDONE 



;PUT MESSAGE IN RESULT 
JSTRING TYPE 



i zero count 
;ko7E to result 



MESSAGES 



TYPMSG D3 
DT 



0,0, 10 

'TYPE ERROR' 



DB 
0T 



0,0.14 
'ARGUMENT 



SIR OR' 



END 



NBICE 
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Listing of and output from a BASIC program that utilizes 
the CONCAT assembly language routine. 



lEADY 

LIST 

10 DIM A$(250),B${250) .C$(250) 

2Z MEM END 16R5FFT 

30 LOAD "CONCAT" 

40 PIF FAA=16H6040 

^0 IMPUT A$ 

60 INPUT B$ 

72 C$=IAA{A$,B$) 

S0 FBINT C$ 

92 GOTO 5Z 

REABY 

BUN 

1 12345 

? 67893 

123456789? C 

? NOW IS THE TIME 

? FOR ALL GOOD MEN ft 

NOW IS THE TIMEFOE ALL GOOD MEN 

IKTEBRUPT 

60 INPUT B$ 

BEADY 

PRINT FAAfA$) 

ARGUMENT ERKOH 

EEAEY 

PHINI FAA(A,1) 

TYPE EEBOH 

READY 

PE INT FAA( ■ 12345 ■/•673Sa" ) 

1234567890 

READY 
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Pages 5-30 through 5-32 left blank Intentionally. 






Rev. 7 3/73 5-30 



5.19 BASIC EXPRESSIONS 

A BASIC expression is a combination of data items and function references 
connected by operators. An expression specifies an operation or series of 
operations that yields a single value, which is referred to as the value of 
the expression. Data items may be constants, simple variables, or array 
elements. Operators may be arithmetic, string, relational, and logical. 

5.19-1 Evaluation of Expressions 

BASIC contains a precise set of rules which define the manner in 
which expressions are evaluated: 

1) Operator Precedence -- Operators encountered in an 
expression are performed in the following order: 

1) Function references 

2) Dnary operators 

3) Arithmetic & string operators 

4) Relational operators 

5) Logical operators 

2) Operators which have the same level of precedence are 

perforn«d in the order in which they are encountered 
in scanning the expression from left to right. 

3) The normal rules of precedence 5t order of evaluation 
may- be overridienby the use of parentheses to partition 
an expression into subexpressions. Nesting of sub- 
expressions is limited by the overall complexity of the 
expression. If an expression is too complex it may cause 
a STACK OVSRFLCW error. In this case, the expression 
should be broken into two expressions. 

4) Expressions containing subexpressions are evaluated 
from the innermost subexpression outward to the next 

level of parenthesis until all parenthetical expressions 
have been evaluated. Within a subexpression the rules 
given for operator precedence and order of evaluation 

apply. 

5.19.2 ITumeric Expressions 

A numeric expression consists of numeric function references, numeric 

operators, and numeric data items and evaluates to a numeric result. 
Operations are performed in the following order: 
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1) Function references 

2) Unary + ^nd - 

3) Exponentiation 

4) Division and Multiplication 

5) Integer division 

6) Addition and Subtraction 

Parentheses may be used to force evaluation in the exact order desired, 
EXAMPLES: 

1. 2*3+7*4 

This expression is evaluated as follows: (V(x) indicates the value 

of x) 

1) 2*3 yields 6 

2) 7*4 yields 28 

3) V(2*3) + V(7*4) yields 34 

2. 2*<3+7) *4 

This expression is evaluated as follows: 

1) 3+7 yields 10 

2) 2* 7(3+7) yields 20 

3) 7(2*^(3+7)) *4 yields 80 

5.19.3 String Expressions 

A string expression consists of string function references, string 
operators, and string data items and evaluates to a string result. 
Operations are performed in the following order: 

1) Function references 

2) Concatenation 

SXAHP1£: Let B$ » "The number is" 

B$+STE$(134) 
This expression is evaluated as follows; 

1) STR$<134) yields " 134 " 

2) V (STR$(134)) is concatenated with the current 

value of B$ which yields '1016 number is 134 " 
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5.19.4 Lor leal Expressions 

A logical expression consists of numeric and string expressions 
combined with relational and logical operators. The value of a 
logical expression is a Boolean value. Operations are performed 
as follows; 



1) Function references are performed. 

2) The NOT operation is performed. 

3) Numeric and string ex-nressions are evaluated, 

4) Relational operations are performed 

5) The AND operations are performed 

6) The OR operations are performed 

7) Parentheses may be used to force evaluation in the exact order 
desired 

EXAMPLE : 

A+2<=3 AND B+3<5 OR NOT (B§="A") 

This expression is evaluated as follows; 

1) The value of B$ is compared with "A" (Note; if parentheses 
had not been used, BASIC would have tried to T^erform NOT 
B$ which would have given an error) Temporary result Tl is 
set =1 if B$-"A" else is set =0 

2) Tl is complemented 

3) A+2 is evaluated 

4) B+3 is evaluated 

5) The value of A+2 is compared with 3 and a temporary result 
T2 is set =0 if A+2>3 or 1 otherwise, 

6) The value of B+3 is compared with 5 and T3 is set =>0 
if B+3 Is greater than or equal to 5 else is set =1. 

7) T2 is ANDed with T3 yielding T4 

8) The value of the expression is obtained by OR'ing T4 
with Tl 

Note: The NOT operator complements the 16 bit representation of 
Boolean values so the final value of this expression is 

65535 if true and 65534 if false. 
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5.20 BASIC STATEMENTS 

BASIC statements specify opera cioas to be performed In a BASIC program, and 
describe the data and operating environment of the nrogram. 

Every BASIC statement consists of a keyword followed by a list of zero or 
more expressions which specifies the operation to be performed by the 
s ta tement . 

Multiple statements may be included in the same program line separated by 
the colon (:) (see section 5.2 ). 

The statements included in the BASIC language are listed alphabetically 
and described in detail in the following pages. Conventions of notation 
used are: 



1) 



Bf 



B >• Indicates a choice of one of the items enclosed. 



2) £ J Indicates optional items. 

3) Parentheses ( ) used in definitions must be included as 

illustrated. 



5.20.1 DATA {numeric constant! fnameric constant") 

1 string constant j , Istriag constant J , . . 

150 DATA 25, "APRIL 1, 1977", 26E-3 

The DATA statement is used to define a list of data internal 
to a BASIC program which may be accessed with the READ sta te- 
nant. When a BASIC program is started, the DATA "ointer is 
initialized to point to the first data item in the first DATA 
statement in the program. When a READ statement is executed, 
one value is read from the list for each variable specified 
and the pointer is advanced to noint to the next data item. 
When the data items In a DATA statement are depleted, the 
pointer is set to point to the first data item in the next 
DATA statement encountered in the program such that all the 
data values contained in DATA statements constitute a con- 
tiguous list. "Hie RESTORE statement can be used to re-position 
the DATA pointer to point to the first data item of any DATA 
statement within the program. 

The DATA statement is non-executable and may therefore appear 
anywhere within a program. 
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5.20.2 DEF JFN letter ^(function parameter name)! = erpression 

10 DEF FNA - X+Y+Z 

100 DEF FNL(A)- (4*3. 1415*A)/3 

150 DEF FM(M$)= EEPEAT$(M$.5) 

The DEF FN statement is used to define a function. 
The name of the function defined is "FN" followed 
by one of the letters A-Z. Each function name may be 
defined only once in a given program. 

For example, if the statement 110 DEF FNN= 3.1415*R2 
were used in a program. 260 DEF FM (M$)=EEPEAT(M$,5) 
could not be used because the function names are 
identical. The statement 260 DEF FNM (M$)-REPEAT(M$,5) 
would be legal. 

A function r.arameter is optional. If ''resent, it Is a 
dummy "parameter and its name may be any simr>le variable 
name. A function will return a numeric or string value 
depending upon the form of the expression. 



A DEF FN- ■ s ta tement is non-executable and may appear 
anywhere in a program. 

5.20.3 DEF FA letter = numeric expression 

90 DEF FAA = 16R7000 

The DEF FA sta tenant Is used to define a function which 
provides linkage to an assenAly language subroutine. 
The function name consists of the letters "FA" and one 
of the letters A-Z. The expression contains the starting 
address of the assembly language subroutine. See section 
5.18.2.2 "AssenAly Language Functions" for details of 
linkage and passing arguments. 
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5.20.4 DIM letter [%! (II, 12, ... 14) 

DIM letter $( length) 

DIM letter $(I1, ... 13, length) 

10 DIM A (2,4) 

20 DIM B%(2,3,4,5) 

30 DIM A$(40) 

40 DIM A$(2,3,40) 

The DIM statement is used to define the maximum length of 
string variables and to define the number of dimensions and 
index ranges for arrays. 

The first form of the DIM statement is used to define a 
numeric array. The array name consists of one of the letters 
A-Z, An optional percent sign (%) may follow the letter to 
denote an integer array. The array may have 1 to 4 dimen- 
sions as defined by the number of parameters (I). The value 
of each I defines the maxiiraiin value of the index for Aat 
dimension. 

The second form is used to set the maximum length of a 
string variable. The name of the variable is one of the 
letters A-Z followed by the dollar sign ($). The length 
specified must be less than or equal to 250 and overrides 
the default length specified in the SIZES statement. 

The third form Is used to define a string array. The array 
name consists of one of the letters A-Z followed by the dollar 
sign ($), A string array may have 1 to 3 dimensions as 
defined by the number of parameters (I) specified. The value 
of each I defines the maximum value of the Index for that 
dimension. The last parameter specified in the parameter 
list is the maximim length of each string element. 

Dimension statements are executed dynamically, therefore 
the parameters may be either constants or expressions. 

5.20.5 mo 

10000 END 

The END statement Is optional in BASIC. Execution will 
terminate when the END statement is executed and may not 
be continued with the CONT command. It is recommended 

that an END statement be the last statement of a program 
to serve as a listing aid. Its presence ensures that the 
listing is complete. 
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5.20.6 EXEC string expression 

100 EXEC A$ 

The EXEC statement is a feature unique to Micropolis BASIC. 
The EXEC statement causes the string exnression to be passed 
to the BASIC Interpreter and to be executed as a statement. 
The expression may consist of one or more BASIC statements 
separated by coLons(:). The expression passed is checked for 
syntax errors and then executfed if valid. The following 
program is given as an example of the power inherent in this 
statement. The program accepts arithmetic statements from 
the terminal and prints the results -- effectively operating 
the terminal as a desk calculator. 

LIST 

10 INHJT A$: EXEC "PRINT '"+A$': GOTO 10 
HEADY 

mm 

? 2+2 

4 
? SIK(3. 14159/4) 

.70710595 



5.20.7 FLOW 



10 FLOW 



The FLOW statement turns on the program trace feature which 
aids in debugging BASIC prograas . The program trace will out- 
put to the terminal the program line of each statement which 
is executed. The program line will be output again if the 
THEN portion o£ an IF . . . THEN statement is executed. The 
program trace is turned off by the NOFLOW statement. 
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5.20.8 FOR numeric * numeric TO numeric STEP numeric 

variable expression expression expression 

30 FOR X = 1 TO 30 

40 FOR Y = 30 to STEP -1 

50 FOR X = A to B 

The FOR statement Initiates the repeated execution of a set 
of statements following it. The set begins with the statement 
immediately following the FOR statement. The set ends with 
the NEXT statement that contains the same variable as the 
FOR statement. The nun»ric variable controls the number of 
times the set of statements is to be executed and is called the 
loop variable. The set of statements to be executed is 
referred to as a FOR . . NEXT loop. 

The expressions specify the initial value of the loop 
variable, the terminal value of the loop variable, and the 
value to be added to the loop variable after each pass 
through the loop (step). The step parameter is optional; 
when not specified, a default value of +1 is used. 

The statements within the FOR . . . NEXT are executed 
until the value of the loop variable is stepped outside 
the range defined by the initial and terminal values. 

The STEP value can be negative, as in: 

20 FOR I = 10(0 to a STEP -10 
This statement would cause the initial value of the loon 
variable I to be set at IM, subtract 10 from the looo 
variable each time the loop was completed, and terminate 
executing the loop when the loop variable contained the 
value 0. 

The statement 15 FOR J =» TO would cause the FOR loop 
to be executed one tin«. That is, the statements between 
the FOR J. . . . and the NEXT J statements would be executed 
once before the loop variable of fi + 1 would be compared to 
the limit value of 0. At this point the loop variable limit 
would have been exceeded and program execution would fall 
through to the next line number. 

A set of FOR . . .TO. . .NEXT statements may be nested within 
one or n»re sets of FOR, . .TO. . .NEXT statements. For 
example: 

l6 FOR K - 1 TO 90 

Zd FOR L =1 TO 15 
30 PRINT K,L 
40 NEXT L 
56 NEXT K 
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When nesting FOR. , .TO. . .NEXT statements it is imperative 
that the inside loop (in this case the L loop) be comoletely 
enclosed within the outer loop. 

If the above statements had been entered incorrectly as follows; 



10 


FOR K » 1 TO 9p 


20 


FOR L = 1 TO 15 


30 


PRINT K,L 


40 


NEXT K 


50 


NEXT L 



The error message "MISSING FOR" would occur when the "NEXT L" 
statement is encountered. 

If a GOTO or IF. . .THEN statement is executed from within a 
loop, the program execution will continue in a normal manner. 
BASIC will continue the loop from the current value of the 
loop variable if the loop is re-entered at some later point. 
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5 , 20 . 9 GOSUB }l Inenunier 



} 



I numeric expression 
210 GOSDB 1000 

The GOSOB statement causes a set o£ atatensents to be executed as 
a subroutine. 

When a GOSDB statement is executed, control is transferred to the 
first statement whose line number is specified in the GOSUB 
statement. The referenced line number and all statements following 
it will be executed until a RETURN statement is encountered. 
Control is then returned to the statement following the GOSUB. 
Consider the following: 

150 GOSUB 210: PRINT A + B 

160f END 

2lQf INPUT X,Z 

220 A = X + 1: B » 2-10 

230 RETURN 

When line number 150 is executed, control is transferred to line 
number 21Q^. Line 210 and 220 are executed, then 230, the RETURN 
statement. The RETURN causes control to be transferred to the 
staten«nt immediately following the GOSUB. Therefore, the sum 
of A +B will be printed before the program ends. 

GOSUB statements can be nested. That is, a subroutine can 
contain a GOSUB statement that references another subroutine. 
Control will be returned to the first subroutine when the RETURN 
statement of the second is executed. The message STMT # NOT 
FOUND will be output if a GOSUB statement references a line 
number that does not exist in the program. 

BASIC allows an expression to be used as the line number. If 
this is done, care must be taken to insure that the value of 
the expression is a positive real number. The fractional part 
of the number will be truncated in forming the line number. 
A NUMBER OUT OF RANGE error will occur if the number is invalid. 
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5.20.10 GOTO I line number 

j numeric expression 

100 GOTO 5000 
200 GOTO A+B 



i 



The GOTO statement causes control to be transferred to the first 
statement in a specified program line. A GOTO statement nay 
reference any line in a program, including its own line. The 
line nuniier may be specified as a constant or a numeric expression 
Care nxist be taken to ensure that the expression evaluates to a 
positive real value. 'Hie fractional part of the number will be 
truncated in forming a line nusiber. If the value is invalid, a 
NUMBER OUT OF RA1K3E error will occur. If the line number does 
exist in the program, a STMT # NOT FOUND will occur. 

5.20.11 IF logical expression ( T THEN 1 STATEMENT FiSTATEMENtI 

THEN line number 

10 IF A < B THEN PRINT "*" 

20 IF, A « 2 GOTO 100 

30 IF A - 4 THEN 100 

40 IF A * 2 AND C = 3 THEN D = 2: GOTO 1000 

The first form of the TF statement provides conditional exscution 
of one or tootb statements based upon the value of a logical 
expression. 

The statenents subject to conditional execution nnist all reside 
within the same program line as the IF statement. If the logical 
expression evaluates to "true", then the statements are executed. 
If the expression evaluates to "false", then all remaining state- 
ments within the line are ignored. The keyword THEN is optional 
in this form. 

The second form of the IF statement provides a conditional 
program branch based upon the value of a logical expression. 
If the expression evaluates to "true", control is transferred 
■to the first statement in the specified program line. If the 
expression evaluates to "false", program execution continues 
at the next sequential program line. The line number must be 
specified as a constant. If the line number specified does not 
exist in the program, a STMT # NOT FOUND error occurs. 
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5.20.12 INPUT ["prompstring"tJ;J variable list 

10 INPUT A,A$ 

20 INPUT "ENTER NUMBERS"; A.B 

The INPUT statement prompts for data to be entered from the 
tenninal and waits for the user to enter the data. If a 
prompt string followed by a semicolon (; ) is included, the 
string is output, followed by a question mark (?) before 
waiting. If a prompt string followed by a comma (,) is 
included, the string is output and then the question mark 
is output on the next line before waiting for entry. If 
no prompt string is included, a question mark is output 
to the next terminal line before waiting for input. 

One value must be entered for each variable in the variable 
list. Values may be numeric or string constants separated 
from each other by the current string delimiter. Strings 
entered do not need to be enclosed in quotes (") unless they 
contain the string delimiter. If a string constant is 
erroneously entered In place of a numeric constant, a 
TYPE ERROR occurs, followed by the message REENTER FROM 
BEGINNING. This means that all values in the variable list 
should be entered again in proper order. The last value 
entered is delimited by a carriage return. If too few values 
are entered, INSUFFICIENT INPUT is output to the terminal and 
the statement waits for more input to satisfy the variable 
list. If too many values are entered, EXTRA INPUT IGNORED 
is output to the terminal and the program continues execution. 

5.20.13 [LET] variable = expression 

10 LET A = 5 

20 A$ = "FAT HIPPO" 

The LET statement causes the expression to be evaluated and 
assigns the resulting value to the variable. The data type 
of the expression and the variable must be the same type or 
a "TYPE ERROR" results. The LET keyword is optional. 
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3.20.14 MEMSND numeric expression 

10 MEMEKD 16R7000 

The MEMEND statement is used to define the upper limit of the 
memory space used by BASIC, One of the main applications of 
this statement is to reserve memory for assembly language 
subroutines which may be placed above the address specified 
by the expression. 

5.20.15 NEXT numeric variable 

10 NEXT X 

The NEXT statement terminates the loop initiated by the 
FOR statement that contains the same variable. While the 
loop is being executed, each time control reaches the NEXT 

statement, the loop variable is incremented by the STEP 
value, or by 1 if a STEP value was not defined. 

When loop execution terminates, control passes to the 
statement following the NEXT statement. 

If a HEXT statement is encountered prior to the execution 

of a FOR statement naming the same loop variable, a 'MISSING 
FOR error occurs. 

5.20.16 NOFLOW 

500 NOFLOW 

The NOFLCW statement turns off the program flow trace 
which may be activated by a FLOW statement. 

5.20.17 ON numeric expression GOTO line nun4>er list 

100 ON K+5 GOTO 200, 300, 400 
200 ON J GOTO A+50, 400, B 

The ON, ..GOTO statement causes control to be transferred to 
the line number whose positional value in the line number list 
is equal to the expression. If the excression is zero or 
greater than the nunJser of lines in the list, control is 
passed to the next statement. If the expression is fractional, 
the fraction is truncated prior to the GOTO being executed. 
If the expression is negative a NUMBER OUT OF R/^NGE error 
occurs. The line numbers in the line number list may be 
numeric constants or numeric expressions. If a line number 
in the list does not exist a STMT # NOT FOUND error occurs. 
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5.20.18 ON tmneric expression GOSUB line iiumfaer list 

100 ON X GOSUB 500, 600, 700, 800 
200 ON Z+2 GOSUB B.C. 600 

The ON. ..GOSUB statement causes execution of the subroutine 
beginning at the line nun&er whose positional value in 
the line number list is equal to the value of the numeric 
expression. 

If the expression is zero or greater than the number of 
lines in the list, control Is passed to the next statement. 
If the expression is fractional, the fraction is truncated 
prior to the GOSUB being executed. If the expression is 
negative a HDMBER OUT OF RANGE error occurs. 

The line nun4»ers in the line number list may be numeric 
constants or numeric expressions. If a line number in the 
list does not exist a STMT # NOT FOUND error occurs. 

When a RETURN statement is encountered in the subroutine, 
control returns to the statement followng the ON. ..GOSUB 
statement. 

5.20.19 OUT (numeric expression 1) - numeric expression 2 

100 OUT (16R10) = 20 

The OUT statement causes che value of expression 2 to be 
output to the I/O port specified by exnression 1. Both 
expressions must be numeric expressions with values in the 
range to 255 or a NUMBER OUT OF RANGE error occurs. 

5.20.20 POKE (numeric expression I) = numeric expression 2 

100 POKE (16R6000) = 200 
200 POKE (A) = B 

The POKE statement stores the value specified by expression 
2 in the meiMry location specified by expression I. Ex- 
pression 1 must be in the range to 65535 and expression 2 
must be in the range to 255, If the value for either 
expression is outside of the specified range, a NUMBER OUT 
OF RANGE error occurs. Care must be exercised to ensure 
that the location POKE'd does not cause BASIC to crash. 
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5.2Q.21 PRINT expression hi rTAB(nunieric expressionj. 



100 PRINT A;B;C 

200 PRINT TAB(10); "THE ANSWER IS"- FMT(A, "ZZ29V. 99" ) 

The PRINT statement causes the value of the expressions in 
the expression list to be output to the terrninal. Expressions 
are output in the formats described in section 5.16.3, 
"Output Formats". 

An output line consists of up to 250 characters and is 
partitioned into 16 character print fields. Print nosition 
within an output line is controlled as follows: 

1) An expression is output starting at the current 
print position. Each expression must be separated 
from the next expression by a comma (,) or a 
semicolon ( ;) . 

2) If the expression is followed by a semicolon, 

the print position is set to the next position 
following the last character output for the 
expression. If the expression is the last 
.'i, express ion of the PRINT statement then output 
/,;: generated by subsequent PRINT statements will 
'•f. start at this position on this line of the output 
on the terminal. 

3) If the expression is followed fay a comma, the 

print position will be set to the beginning of 
the next 16 character print field after out- 
putting the expression. If the expression is 
the last expression of the PRINT statement then 
output from subsequent PRIST staten»nts will 
begin at this position on this line of output 
. .i on the terminal. 

4) If the last expression of the PRINT statement is 
not terminated by a comma or semicolon then the 
print position is set to the first character of 
the next line after outputting the value of the 

exfireasion. 

5) The print position may be explicitly set by including 
references to the tab function which operates only 

in PRINT or PUT statements. TAB moves the rjrint 
position to the position snecified by the value of 
the tab function parameter. If the position is 
already beyond the specified value when the print 
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stateaetit is executed then the specified value is 
simply ignored. 



BASIC contains a paraneter which specifies Che length of a 
physical output line on the terminal. If a print line 
which is longer than the terminal width is output, carriage 
returns and line feeds will automatically be inserted to 
wrap the output across as many physical lines as necessary. 
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5.20.22 EEAD variable list 

10 READ A,B,C$ 

The READ statement reads values from the BASIC programs 
internal data list which is created by including data 
statements within the program. One value is read from 
the data list for each variable appearing in the variable 
list. If there is insufficient data in the data list to 
satisfy the variable list then SAN OUT OF DATA will be 
output. If a string value is read for a numeric variable 
then a TYPE ERROR will occur. Values are read sequentially 
from the data list unless the pointer which points to the 
next value to be read is repositioned by use of the RESTORE 
s ta tement . 

5.20.23 HEM remark text 

10 REM THIS JUNK IS A REMARK AND IS NOT EXECUTED 

The REM statement is used to include comment text. The 
character (.') may also be used to Include comments in a 
program line. The REM statement and any characters fol- 
lowing a (.')■ character in a program line are non-executable 
and are ignored. 



5.20.24 RESTORE j numeric expression! 



10 RESTORE 
2& RESTORE 25 

The RESTORE statement is used to position the data list 
pointer which allows control of the sequence in which 
data items are read from the program's internal data list. 
The pointer will be set to the first data item of the data 
statement whose line nuidser is specified by the numeric 
expression. If an expression is not specified, the pointer 
will be set to the first item in the first data statement 
appearing in the program. 

5.20.25 RETDRN 

100 RETURN 

The RETURN statement transfers control to the statement 
inmediately following the last GOSUB statement executed. 
If a RETURN statement is encountered prior to the execution 
of a GOSUB statement the error message tlOTHING TO RETURN 
TO is output to the terminal. 
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5.20.26 SIZES /numeric numeric numeric rhumeric 

i constant 1, constant 2, constant 3, |_^constant 4 

20 SIZES (5,4,80) 

30 SIZES [6.5,40,3000) 
The SIZES statement is used to specify the number of bytes 
of storage to be used for real variables (RSIZE), integer 
variables (ISIZE) and string variables (SSIZE), and the 
maximum program size when using chained program segments 
(see section 5.21.2.6). Constant 1 - constant 3 are positive 
integer constants. The value of constant 2 specifies ISIZE 
which must be greater than 1 and less than RSIZE. The value 
of constant 1 specifies RSIZE which must be greater than 
ISIZE and less than 30. The value of constant 3 specifies 
SSIZE which must be greater than and less than 251. 

Constant 4 is an optional parameter. If it is present it 
specifies the maximum number of bytes allocated for program 
size, after which variable space allocation begins. 

If no SIZES statement is executed, the default SIZES are 
(5,3.40). 

The SIZES stateirent may not be executed If any variables are 
already allocated. If any of the constraints described are 
violated, a SIZES ERROR error occurs. 

5.20.27 STOP 

100 STOP 

The STOP statement causes the execution of a BASIC program 
to cease. The execution may be resumed from the line 
following the STOP statement with a CONT comnand, 

5.20.28 STRING string expression 

10 STRING ";" 

The STRING statement defines the current string delimiter 
used to tenninate a string accessed by an INPUT or GET 
statement. The end of string will be signified by either 
the end of the record or the first occurence of the string 
delimiter. If a STRING statement has not been executed, 
the default delimiter is the comma (,). 
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5.21 BASIC DISK FDJl I/O 

A file is a data structure which may be accessed as a named entity and consists 
of a collection of data grouped into elementary units called records. The file 
structure is generally used for storing data on mass storage devices such as a 
disk. Disk Extended BASIC provides the ability to create and access files stored 
on the disk. Conmon maintenance operations such as renaming or deleting a file 
are included. 

5.21.1 Disk Files 

Each file stored on a diskette is identified by a file name, which may be 
from 1 .to 10 characters long, ihe characters may be letters, digits 
0-9, or the special characters period (.), slash (/), or hyphen (-). 

The minimum amount of space required to store a file is one track. When a 
"new" file is opened, a complete track is allocated. This track and any 
other track assigned by the BASIC file system to this file remain unavail- 
able to any other file until released by the user. The maximum number of 
files that can be stored on a disk is a function of the number of tracks 
available on the disk. The Mod I disk drive provides 35 tracks per 
diskette; Mod II provides 77 tracks' per diskette. One track per diskette 
is required for the file directory, so the maximum number of files is 
either 34 or 76. Conversely, the maximum size of a file is 34 or 76 
tracks. Each track consists of 16 sectors of 256 bytes per sector. A 
file is accessed sector by sector; therefore a "record" is 1 sector. 

Actual placement of files is maintained by the BASIC file system. One 
track is allocated for each "new" file opened. When 16 records have been 
written to a particular file, another track is allocated. The file 
appears contiguous to the program, even if it is not stored on contiguous 
tracks. It is not possible to store one file on more than one disk; that 
is, a file may not span disks. 

Files may be stored in 3 formats: Program, Object and Data. 

1) Program Files - A program file is a BASIC program which was stored 
by a SAVE command as described in section 5.6. The data consists 
of the BASIC program text as it resided in the program buffer with 
keyword compression. A LOAD command will load the data from a 
program file into the BASIC program buffer. 

2) Object Files - An object file is an image of a block of memory 
which was saved using the memory range option of the SAVE command. 
A LOAD conmand will read the data back into the menwry locations 
from which it was saved. This is the format in which assembly 
language programs may be stored on the disk. 
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^5 Data Files - Data files contain data created by and are 
accessible to BASIC programs by use of the PUT and 
GIT statements. Each execution of a PUT statement 
stores 1 record In the file. Datsi within each record 
is represented as ASCII characters. 

Each record is a 250 character string. A data file 
may not be loaded using the LOAD coinmand. Mlcropolis 
BASIC provides the ability to access the records of a 
data file either sequentially or directly. (commonly 
referred to as random access) 

In addition to the format, a file may also have Write 
Protect and Permanent attributes, 

1) Write Protect - A file which is Write 
Protected cannot be re-written but may 
be deleted by a SCRATCH command. This 
is a software Write Protect not related 
to the physical Write Protect provided 
by a Write Protect tab installed on a 
diskette. If a physical Write Protect 
tab is installed on a diskette, all 
operations which attempt to modify a 
file or the directory will yield a 
WRITE PROTECT error. 

^) PeTnanant - A Permanent file may be re- 
written but may not deleted by a SCRATCH command. 

A file may be both Permanent and Write Protected. 

Several '^teywords are provided to manipulate disk files as described 
below: 

5.21.2 Disk File Comtnands 

''"-mands are provided to load and save program or abject files, delete 
'^lle, and to display a list of the files which reside on a diskette. 
Although commands may appear in a BASIC program, commands will generally 
be executed in Immediate mode. All disk commands reference the directory 
o£ the desired diskette. If the diskette is not loaded or a malfunction 
exists in the disk drive which causes it to return a not ready status 
the message JRIVE NOT UP will be outout to the terminal when a cotnmand 
is executed. If the drive is unable to read or write on the diskette 
properly then a pEBM I/O ERROR will result; 
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5.21.2,1 DISPLAY string expression 

DISPLAY "1: DIE" 
DISPLAY A$ 

The DISPLAY conmand will output the directory of the diskette loaded 
into the drive specified by the string expression. Tlie value of the 
string expression must be of the form: 



" ["unit:! DHL" where unit is the drive 



unit address in the range of to 3. If omitted, drive is assumed. 
If the string is a constant it oust be enclosed in quotes (") . If 
a directory does not exist on the diskette a FILE NOT FOtTND error 
results. 

5.21.2.2 LOAD string expression 

LOAD "2: DEMO PGM" 

The LOAD command loads a program or object file into memory. The 
file is specified by the string expression which must evaluate to 
the following form: 



" [unit:! filename" where unit is the 



unit address in the range to 3. If omitted, unit is assumed; 
The file name may be any valid filename. If the string is a constant 
it nnist be enclosed in quotes ("). If the desired file doas not 
reside on the diskette a PILE NOT FOUND error results. If the 
file is a data format file, a NOT A LOAD FILE error results. 



5,21.2.3 PLOADG string expression 

PLOADG "0:NEXTSEG" 

The PLOADG statement operates like a combined IX)AD command and RUN 
command. It loads the program file named in the string expression 
into the current program buffer and then transfers control directly 
to the logic of the RUN command. All variables and file status from 
the preceding program are reset to the initialize condition and 
execution begins with the fiist line of the new program. 

The PLOADG statement may be used to cause automatic execution of 
several program files in sequence. This is accomolished by using 
a PLOi^DG statement as the last executed statement of each program 
in the sequence, such that it names, loads and begins the next 
program in the sequence. Note, however, that no nrogram variables 
or open files are retained from one nrogram or segment to the next. 
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The string expression in the PL0.4DG statement must evaluate to the 
following form: 



" t^^^Q 



filename" 



where unit is the unit address in the range to 3. If omitted, 
unit fl is assumed. The file name may be any valid filename. If 
the string is a constant, it must be enclosed in quotes ("), If 
the desired file does not reside on the diskette a FILE NOT FOIMD 
error results. If the file is a data fornat file, a NOT A LOAD 
FILE error results. If the file is an object file rather than a 
program file, it will be loaded just as if a LOAD command had been 
used and the current program will continue executing with the 
statement after the PLOADG statement. 



5.21.2.4 SAVE string expression I memory address rangel 

SAVE "N:1:NEWPRG" 

SAVE "NrLOADER" 16R7S200, 16R7DFF 

The SAVE comnand stores program format or object format files on the 
diskette. The file is specified by the string expression which laist 
evaluate to the following form: 



" r^O [unit:] filename" 



If the file to be saved does not already exist on the diskette, the 
"N:" must prefix the unit/file name to cause the creation of a new 

file in the directory on the diskette. The unit is the drive unit- 
address in the range 0-3. If omitted, unit is assumed. If the 
string Is a constant it imst be enclosed in quotes ("). 



The filename may be any valid filename. 

If the memory range option is not included, the contents of the 
BASIC program buffer will be stored in the desired file in '-rogram 
forma t . 

If the memory range option is specified it must be of the form; 

numeric expression 1, niimeric expression 2 

The numeric expressions must evaluate to positive real values In 
the range - 65535. Fractional parts will be truncated. The 
contents of memory from expression 1 to expression 2 will be 
stored in the desired file in object format. 
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If "N:" is not specified for a new file, a FILE NOT FOUND 
error results. If a file has a Write Protect attribute, 
it cannot be overwritten and a WRITE PROTECT error will 
occur if an attempt is made to save it. If a file specified 
as new already exists a DUPLICATE NAME error occurs. 

5.21.2.5 SCRATCH string expression 

SCRATCH "1 :JUNKFIL£" 

The SCRATCH command deletes a file from the diskette directory 
and releases the tracks allocated to the file for use by other 
files. The file to be scratched is specified by the expression 
which must evaluate to the form: 

"[unit:] filename" where the unit is 

the drive unit address in the range 0-3. The filename may 
be any valid filename. If the expression is a constant it 
must be enclosed in quotes {"). If the unit address is 
omitted, unit is assumed. 

If the specified file does not exist, a FILE NOT FOUND error 
results. If the file has a permanent file attribute then 1t 
cannot be deleted and a PERM FILE error occurs. 

5.21.2.6 CHAIN string expression 

990 CHAIN "NEXTPART" 

The CHAIN statement loads the BASIC program file specified 
in the string expression into -the current program buffer and 
then transfers execution control to the first line of the 
newly loaded program segment. This operation is similar to 
the PLOADG statement with the important exception that the 
CHAIN statement preserves all allocated variables, user 
defined assembly language functions, SIZES parameters, and 
the current string delimiter from the last program segment. 
These preserved values are passed to the newly loaded program 
segment which may use them just as if it had assigned them. 
Note that open file information and user defined BASIC 
functions are not preserved by the CHAIN statement. If any 
files are open when a CHAIN is executed they are implicitly 
closed. This means that the filenumber is disassociated 
from the filename and made free for reuse; but the directory 
is not updated and therefore any changes in the length of 
the file are not recorded. In general, all open files should 
be properly CLOSEd before executing a CHAIN statement. 
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The CHAIN statement is a powerful tool which facilitates 
the construction of programs much larger than available 
system memory would otherwise permit. It makes 1t possible 
to. transfer data and control from section to section of a 
very large program that has been divided into separately 
loadable segments. To use the CHAIN statement effectively 
certain rules must be observed. 

1) The program size of a segment being chained in 
cannot be greater than the program size of the 
program currently in the program buffer. If 
this condition does occur a LOAD OVERRUN error 
will be reported. A procedure for avoiding this 
condition is to specify the size of the largest 
program In a chained program set as the fourth 
argument of a SIZES statffl!«nt (see section 
5.20.26). This SIZES statement should appear as 
the first statement of the first executed program 
of the chained set. The program size of each 
segnKnt can be determined by LOADIng it and using 
the PGMSIZE function (see section 5.18.1.3). 
Assuming a set of three program files named 

SEGl, SEG2, SEG3, the following example Illustrates 
the procedure: 

LOAD "SESl" 

READY 

PRINT PGHSIZE 

472 

READY 

LOAD "SEG2" 

PRINT PGMSIZE 

526 

READY 

LOAD "SEG3" 

PRINT PGMSIZE 

126 

READY 

In this example the largest PGMSIZE is 526. If 
SEGl were the first file to be executed and the 
standard system precisions were desired, then the 
statement SIZES (5.3,40,525) would be included 
as the first statement of SEGl . 

2) All files should be closed before executing a 
CHAIN statement. 

3) A CHAIN statement should not normally be executed 
from within a FOR-NEXT loop. If this Is done only 
the current value of the loop index variable will 
be preserved across the CHAIN. 
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4) A CHAIN statement should not normany be executed from within 
a subroutine. If this is done the RETURN information for that 
subroutine is lost across the CHAIN. 

5} A program segment which is to be CHAINed should not normally 
contain a SIZES statement since SIZES statements cannot be 
executed after any variables have been allocated. The only excep- 
tion is the case of the SIZES statement used to set the maximum 
program size. A special internal test allows such a statement 
to be chained back to as necessary. 

5.21.2.7 LINK string expression 

LINK "MDOS" 

LINK "DISKCOPY" 

The LINK comnand loads the overlay file specified in the string expression 
into memory and transfers control to the execution address of the overlay. 
This command is designed primarily for use with Micropolis supplied overlay 
files such as MDOS and DISKCOPY. These files completely replace BASIC in 
memory when LINKed to. They take over the control of the computer system 
and provide their own operating. commands and dialogue. 

The string expression must evaluate to a valid filename. The file roust be 
an overlay type C through F. If the specified file is not found or the 
disk unit is not ready, control will return to BASIC where the error will 
be reported. -If an unrecoverable disk error occurs during the LINKing 
process, the system will execute a soft halt. This is done because BASIC 
has already been partially destroyed and the new system has not been 
successfully loaded. The computer must be reset and a new system booted in. 

The LINK command can be used to load and transfer control to a machine 
language program file that runs in high memory above the end of BASIC 
(see MEMEND statement). It can return to the BASIC interpreter by jumping 
to the system warmstart address. 

5.21.3 DISK I/O STATEMENTS ,-^,^ 

BASIC statements are provided which allow a BASIC program to create and 
transfer data to .and from data format files, and to perform certain file 
maintenance functions on any type file such as renaming a file or changing 
the attributes of a file. The operation of disk I/O statements differs from 
the disk commands as follows: 
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1) Disk I/O statements refer to files through a orogram 
"File Number". An OPEN statement naist be executed to 
associate a file on the diskette with a urogram file 
number. 

2) When all I/O operations on a file are complete, a file 
must be closed by executing a CLOSE statement. Closing 
a file consists of updating the directory to reflect all 
operations which have been performed since the file was 
opened, and disassociating the file from the program 
file number, CAPTION : A file which has been written to 
™ist ALWAYS be closed or data written to the file may be 
lost. 

Prior to any operation which accesses the disk, BASIC ensures that 
the drive is ready to accept conmands. If the diskette is not 
loaded or a malfunction exists which prevents the drive from 
performing operations then a DRIVE NOT UP error results. If the 
disk is unable to perform the specified read/write operation properly, 
a PEBM I/O ESROR results. 

A program file number may be in the range to 9. As many as 10 
files may be open at once within a program. If an I/O statement 
attempts to access a file which has not been opened by an OPEN 
statement then a FILE NOT OPEN error results. 

If an I/O statement specifies a file number outside the raige 
to 9 then a 'NOT A FILE# error occurs. 

5.21.3.1 OPEN file number string expression options 

10 OPEN 1 "N: NEWFILE" 

20 OPEN 2 "JOE" END 1000 EREOE 5000 

The OPEN statement opens the specified file for access by disk 
I/O statements. The file is selected by the string expression 
which aaist evaluate to the form: 



"£Nj[uiiit:[j fill 



If the file to be opened does not exist on the diskette, the characters 
"N:" must be Included in the unit/filename to cause the creation of a 
new file in the directory. The file created is a data format file. The 
tmit specifies the drive unit address which must be in the range 0-9. 
The filename may be any valid filename. If the string is a constant, 
it must be enclosed in quotes ("). If the unit address is omitted, 
unit is assumed. If the specified file does not exist and is not 
declared as a new file, a FILE NOT FOUND error occurs. If a file 
specified as new already exists, a DUPLICATE NAME error occurs. 
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The filetiutnber must be a numeric expression with a value of - 9. 
The filename specified will be associated with this file number 
until the file is closed and all file I/O directed to the file number 
will be performed using this file. 

Each open file has two associated pointers which point to the next 
record to be accessed in a sequential PUT or GET statement. When 
a file is opened, the sequential GET pointer is initialized to 
point to the first record. The sequential PUT pointer is initialized 
to point to the record following the last record. The last record in 
the file is considered the end of the file for GET statements. The 
last record +1 is considered the end of file for PUT statements. 
For example a 5 record file would have pointers initialized as follows: 

EOF for a GET (Read) 

„. ^EOF for a PUT (Write) 

RECORD 



mmmtm. mmmmmmi^mmmm mmmmmmi^^tim mm^i^mmm^mm mam* 

12 3 4 5 



t 



+ 



Sequential 
GET pointer 



Sequential 
PUT pointer 



An open file may be read from and written to both sequentially and 
directly by record. 

The open statement includes several options which are listed below: 

1) CLEAR - The CLEAR option overrides the normal initialization 
of the sequential GET & PUT pointers. The pointers are 
initialized so that the file is empty. A subsequent GET 
will encounter an end-of-ftle. A PUT will write into 
record 1, This option is generally used to initialize the 
pointers for re-writing a file sequentially. 

2) END numeric expression 

The END option specifies the line number to GOTO when the 
end-of-file is encountered during a read operation. The 
numeric expression must evaluate to a positive real number 
which is a valid program line within the program when the 
fractional part, if any, is truncated. If the line does 
not exist, a STMT # NOT FOUND error occurs. This option 
allows the BASIC program to handle an end-file condition 
without the program being aborted. If the END option is 
not specified, the normal end-file handling is to abort 
the program with an END-FILE error. 
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3) ESROR numeric expression 

The ERROR option specifies the line number to GOTO if a 
disk I/O error occurs. The numeric exnression mist 
evaluate to a positive real number which is a valid 
program line within the program when the fractional part, 
if any, is truncated. If the line does not exist, a 
STMT # NOT FOUND error occurs. This option allows 
a BASIC program to handle disk I/O errors without being 
aborted. If the error option is not included, a disk 
I/O error will cause the appropriate error message to 
be output and abort the program, the ERR function may 
be used in the error handling program section to determine 
the type of error. 

5.21.3.2 PUT filenumber RECORB record number expression List 

100 PUT 1 A;B;C 

200 PUT 1 A;A$-f","; B' 

300 PUT 1 BECORD 3 A;B;C 

The PUT statement causes the values of the expressions in the ex- 
pression list to be written onto a record of the file specified by 
the filenumber expression. The filenumber must be a numeric ex- 
pression having a value of the digits 0-9 when the fractional 
part, if any, is truncated. 

Each execution of a PUT statement writes one record into the file. 

Each disk record is composed of a 250 character string and is, in 
fact, a print line. Each expression in the expression list is 
evaluated, converted to a string if the resulting value is numeric, 
and is placed in the string in exactly the same way that orint lines 
are built. The rules for building the string are as follows: 

1) The record string is partitioned into 16 character fields. 
A pointer which is initialized to point to the first char- 
acter in the string keeps track of the next position in 
the string to be loaded. 

2) Expressions are evaluated as they are encountered in 
scanning the expression list and from left to right, 
and are converted to strings according to the formats 
described in section 5.16.3 "Output Formats". The 
resulting string is loaded into the record string 
beginning at the pointer position. Each expression must 
be separated from the next expression by a comma(,) or a 
seiiilcolon(j) . 
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3) If the expression is followed by a comraaC) after the 
expression has been loaded into the string, the string is 
padded with enough blanks to position the pointer to the 
beginning of the next 16 character field. 

4) If the expression is followed by a semi col or(;), after the 
expression has been loaded into the string the pointer is 
set to the character position following the last character 
of the expression. 

5) After all expressions have been loaded into the record 

string, any remaining characters in the string are padd 
with blanks and the record string is written onto the 
diskette. 

EXAMPLE: If A = 100 and B = -2.5, the statement: 

100 PUT 1 A;B 

would cause the fallowing record to be written on 
the disk: (Note: J6 denotes a blank) 



^•j61£0!!},, - 2.5 m -.■ r 



240 Character pad 



The Statement 



100 PUT 1 A,B 

would cause tne following record to be written to 
the disk: 

'3^?imMmmmmiiJ^2.s m ... »" 



PAD 



229 Character pad 



The expressions in the expression list may be numeric and string in any 
order subject to the following restrictions: (1) If a string expression 
follows a numeric expression it must be immediately preceded by the 
current string delimiter. (2) The last character of a string expression 
must be the current string delimiter. These restrictions Must Be 
Strictly Followed or the expression will not be properly read back. 

On Input, nuiiMric values are delimited by blanks. The output format of 
numeric values always follows the value with a blank, so numeric strings 
built as described will always read back correctly. Strings, however, 
may contain embedded blanks. The input logic which reads a record from 
the disk looks for the current string delimiter to denote the end of a 
string. If a string follows a numeric value, the blank following the 
numeric field will be included in the string unless the current string 
delimiter precedes the string. 
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One solution to this problem is to concatenate the string delimiter 
on all string variable references, include the string delimiter in all 
string constants, and precede all string expressions following numeric 
expressions with the string delimiter. 

EXAMPLE: 

To write the values of A,B$,C, E$ and F$ on the diskette, the PUT 
statement would be 

100 PUT 1 A;%"+B$+",";C;","+E$+",";F$+%" ' 

(This example uses the default delimiter, corama (,)) 

If it is desired to change the string delimiter, the following approach 
could be used to implement the previous example: 

10 D$ = ";" : .' SET STRING DELIMITER 
20 STRING D$ 



100 POT 1 A;D$+B$+D$;C;D$+E$+0$;F$+D$ 

If this approach is used, the string delimiter nwst be the same 
when a record is read as when it was written or incorrect results 
will be obtained. 

If the record option is not included, the record is written into the 
file at the record number specified by the sequentialPUT pointer. The 
pointer is then incremented by 1. 

If the record number option is included, Che record is written into 
the record specified by the record number expression. The record 
number expression naist have a value which is a positive real number. 
The fractional oart is truncated. If the record number is greater 

than. the end-of-file as described in 5.21.3.1, a PARM ERROR 

occurs. 

NOTE; Writing a record directly by use of the RECORD option does 
not affect the sequential put pointer. The pointer will 
only be moved by a sequential POT or execution of a PUTSEEK 
statement. 

If an attempt is made to write more than 250 characters into a 
record, the first 250 characters will be written and the remaining 
characters will be truncated. A warning n«ssage WARNING - TRUNCATED 
OUTPUT will be output to the terminal. 
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5.21,3.3 GET filenumber RECORD record number variable list 



100 GET 1 A,B,C$ 

200 GET 1 RECORD 100 A,B C$ 

The GET statement reads a record from the file snecified by the 
ftlenumber expression and assigns the values read to the variable 
list. The filenumber exTtresslon must evaluate to one of the digits 
0-9. The fractional part, if any, is truncated. 

If a string is read for numeric variable, a TYPE ERROR results. 
If too few values exist in the record string to satisfy the 
variable list, a RAN OUT OF DATA error occurs. If an attempt 
is made to get a record which is past the last record, an END 
FILE error occurs. 

If the RECORD option is not included, the record read is the 

record specified by the sequential GET pointer. The sequential 
GET roiater will then be incremented by 1. 

If the RECORD option is included, the record read is the record 
specified by the recordnumber expression. The expression aaist 
evaluate to a positive real number. The fractional part will be 
trunca ted . 

NOTE: The sequential GET pointer is not affected by a direct 
GET. The pointer will only be modified by a sequential 
GET or by execution of a GETSEEK statement. 

5.21.3.4 CLOSE filenumber 

100 CLOSE 1 

The CLOSE statement causes the file specified by the filenumber 
expression to be closed for disk I/O. The filenumber exnression 
must evaluate Co one of the digits 0-9 when the fractional "art 
is truncated. 

Closing a file consists of updating the file entry in the diskette 
directory to reflect all operations which were performed upon the 
file since it was opened, and disassociating the file from the 
program filenumber. As a rule, all files which are opened in a 
program should be closed before the program terminates. All files 
which have been written into m ist be closed or the directory will 
not be updated and data written into the file may be lost. Any 
files which are left open are implicitly closed by a RUN cotmnand 
or any command that modifies the nrogram buffer, such as a DELETE, 
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LOAD or line insert ion/delet ion. Implicit closure does not update 
the directory. 

5.21.3.5 ATTRS (filenumber) = numeric expression 

100 Arms (2) « 19 

The ATTRS statement sets the file attributes of the file referenced 
by the filenumber to the value of the numeric expression. The file- 
nuni>er expression must evaluate to one of the digits 0-9 ^en the 
fractional part is truncated. The nunaric expression, when the 
fractional part is truncated, must evaluate to a valid combination 
of the attribute values which are described below; 

VALUE AITRIBUTS 

16 Program File 

8 Object File 

2 Permanent File 

1 Write Protect 

A file which does not have a Program or Object attribute is assumed 
to be a Data Format file. Son« examples are: 

19 '= 16+2-J.l « Write protected, permanent, Togram file 
9 » 8+1 ^. =■ Write protected, object file 
26 " 16+8+2 = Invalid combination - This would identify 

a file as being a Permanent Program file and 
Object file, which is not possible. 

A main intent of the ATTRS statement is to allow the user to change 

the Write Protect and Permanent attributes only. The File Format 
attributes should not be changed. The current value of the attribute 
parameter may be accessed by the ATTE function- 

5.21.3.6 EOF (filenumber) -expression 

150 EOF (9) » 50 

The EOF statement sets the file length parameter of the file 
referenced by the file number to the value of the expression. 
The filenunier expression must evaluate to one of the digits 
0-9 when the fractional part is truncated. The expression 
must evaluate to a positive real nunber. Hie fractional part 
will be truncated. The EOF sta tenant is used to decrease the 
length of a file. The value of the expression should be set to 
1 greater than the last record number. For example if a file 
contains 100 records and it is desired to delete the last 50 
records, the statement 

100 EOF (I) - 51 
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would cause record 50 to be the last accessable record. The following 
cautions apply to the use of EOF statement: 

1) The EOF statement does not reset the sequential PUT'GET 
pointers. If they are set beyond the new EOF an END-FILE 
error will occur if a PUT or GET is attempted. Reset the 
pointers to the proper values with the GSTSEEK and PUTSEEK 
statements. 

2) Do Not Set The EOF Beyond the true length of the file. 
Any sectors remaining on the last allocated track may be 

read by a GET and will yield garbage. 

3) Resetting the EOF does not release the now unused tracks 
for system use. De-allocate the unused tracks by executing 

a FREESPACE statement. 

5.21.3.7 IKEESPACE fllenumber 

100 FlEESPACl 1 

The FREESPACE statement de-allocates any tracks allocated to the 
file referenced by filenumber which are beyond the current end of 
file. Filenumber expression must evaluate to one of the digits 
0-9 when the fractional part is truncated. If there are no 
excess tracks allocated an "END FILE" error results. 

5.21.3.8 GETSEEK (Slenuiaber) = numeric expression 

50 GETSEEK (1) =20 

The GETSEEK statement sets the sequential GET pointer associated 
with the filenumber to the value of the numeric exoression. The 
filenumer expression must evaluate to one of the digits 0-9 when 
the fractional part is truncated. The numeric expression must 
evaluate to a positive real number. The fractional part is 
truncated. The value naist be greater than sero and less than or 
equal to the last record number or a PAEM ERROR or END FILE 
error will occur when a sequential GET is performed. The current 
position of the pointer may be accessed by using the RECGET function. 

5.21.3.9 PUTSEEK (filenumber) " numeric expression 

100 PUTSEEK (2) - 30 

The PUTSEEK statement sets the sequential PUT pointer associated 
with the filenumber to the value of the numeric expression. The 
filenumber expression nust evaluate to one of the digits 0-9 
when the fractional part is truncated. The numeric expression must 
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evaluate to a positive real number. The fractional part is truncated. 
He value must be greater than zero and less than the last record 
number +2 or a PAEM ERROR will occur when a sequential POT Is 
performed. The current value of the "Ointer may be accessed by 
using the RECPDT function. 

5.21,3.10 EENAtffi ( ftlenumber) = string expression 

100 RENAME (1) = "NEWNAME" 

Hie RENAME statement changes the name of the file referenced by 
the filenuDjber to the value of the string ex'-^ress ton. The file- 
number expression nust evaluate to one of the digits 0-9 when 
the fractional part is truncated. Hie string expression must 
evaluate to a valid file name. The current name can be accessed 
using the HAME function. 

5.21.4 DISK I/O FUNCTIONS 

Disk File I/O functions are included within BASIC to provide information 
about a currently open file. Each function reference includes a file 
number expression which must evaluate to one of the digits 0-9 when the 
fractional part is truncated. If the specified file number does not 
have a file currently opened to it a FILE NOT OPEN error occurs. The 
disk file I/O functions are detailed in table 5.5, 



5-63 
Rev. 2 5/77 



TABLE 5,5 



DISK I/O FDNCTTOMS 



Function 
Reference 



ATTR (n) 



VALUE 



Returns the attribute parameter associated with 

file a. See section 5.21.3.5 for a description 
of the value. 



ERE 



Returns the error code associated with the last 
disk error. The error codes are: 

- No Error 

1 - Permanent I/O Error 

2 - End- File 

3 - Disk Full 

4 - File Not Found 

5 - Duplicate Name 

6 - Parameter Error 

7 - Drive Hot Up 

8 - Permanent File 

9 - Write Protect 

11 - Invalid File Name 

12 - Printer Attention 





The error code is not reset by a successful operation,! 
so is nffianingless unless an error occurs. > 


EHil$ 


Returns the error message string associated with the 
last disk error. 


NAME (n) 


Returns a string containing the name of the file 
associated with file number n. 


RECGET (n) 


Returns the value of the sequential GET pointer 
associated with file number n. 


RECPOT (n) 


Returns the value of the sequential PUT pointer 
associated with file number n. 


SIZE (n) 


Returns the, SIZE (in records) of the file associated 
with file nujttber n. 


TRACKS (n) 


Returns the number of disk tracks currently 
allocated to file number n. 


FREETR (n) 


Returns the number of disk tracks currently 
available for allocation (free) on the disk 
unit associated with file number n. 
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5.22 BASIC PRINT FILE OUTPUT 

Micropolis BASIC provides a set of print file output features for systems which 
have a hard copy printer device in addition to the standard keyboard-display 
terminal. This section specifies each of the printer related language features 
and discusses how to use the available features to solve some conmon printer 
programning problems. 

5.22.1 Printer Related Language Features 

The printer related language features consist of seven statement and option 
keywords. They achieve a high flexibility of output control by expanding the 
disk file I/O scheme to include print file and terminal file output and by 
adding a physical device assignment capability. Following are descriptions 
of each statement syntax and function. 

5.22.1.1 OPEN filenumber string expression option(s) 

10 OPEN 1 "*P" PAGESIZE 66 ENDPAGE 900 
20 OPEN 2 "*T" 
30 OPEN 7 "*N" 

The syntax of the OPEN statement in this context is the same as that 
for disk files as shown in section 5.21.3.1. The statement associates 
a filenumber with a filename specified in the string expression. 
The filenumber must be a numeric expression with a value of - 9. 
The string expression which contains the filename must have one of 
three specific values which designate a particular output print device. 

1) Filename *P associates the filenumber being opened with the 
system printer. 

2) Filename *T associates the filenumber being opened with the 
display elanent of the system terminal. 

3} Filename *N associates the filenumber being opened with a null 
output device. The output directed to that file will be 
discarded or drained. 

Any other filename will be interpreted as a disk file name per 
section 5.21.3.1. 

There are two print file options available with the OPEN 
statement: 

a) PAGESIZE numeric expression 

This option allows the programmer to set a limit value for 
an internal system counter which counts the number of lines 
output to the associated filenumber. The counter is incre- 
mented on each PUT statement to the associated file, unless 
that PUT statement ends in a corana or semicolon (see section 
5.22.1.2). Each time the limit count is reached, the 
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counter Is reset and the system checks for a correspond- 
ing ENOPAGE option. 

The numeric expression must evaluate to a whole number from 
- 65535. If a print file is opened without a PAGESIZE 
option the internal limit value defaults to a value of 66 
which is the number of lines per page on standard 11 inch 
forms . 

b) ENOPAGE linenumber 

This option specifies a program line number to which the 
system will perform a GOSUB each time that the limit is 
reached on the internal lines per page counter. The line- 
number must be a numeric expression which evaluates to a 
legal linenumber. That line should be the beginning of a 
subroutine which programs some appropriate end of page 
actions and which ends with a RETURN statement. The RETURN 
win go back to the statement inmediately after the PUT 
statement which triggered the end of page action. 

If no ENOPAGE option is specified for a given file the 
internal lines per page counter is just reset each time the 
limit Is reached and processing continues normally. 

5.22.1.2 PUT filenumber expression list 

15 PUT "TOTAL = "; Al , "ITEM NAME ="; B$ 
25 PUT 7 A, B; 

The PUT statement causes the values of the expressions in the 
expression list to be assembled into an output record which is then 
output to the print file device associated with the filenumber. 
The filenumber must be a numeric expression with a value in the 
range 0-9. The expression list consists of a sequence of 
constants and/or variables separated by coimas or semicolons. The 
rules by which the output record is assembled are the same as those 
for PRINT statements as detailed in section 5.20.21. Separate 
carriage width wraparound control is provided for the printer 
device. If the expression list ends with a comna or semicolon then 
no carriage return line feed is output. In this case the internal 
lines per page counter of the associated file is not incremented, 
(see section 5.22.1.1 - PAGESIZE option). The TAB and FMT func- 
tions may be used in PUT statements. 

5.22.1.3 CLOSE filenumber 

90 CLOSE 6 
99 CLOSE 2 

The CLOSE statement causes the file specified by the filenumber 
expression to be closed for output. The filenumber must be in 
the range 0-9. When a print file is closed the associated 
filenumber Is freed for use in a subsequent OPEN to another file. 
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Any files which are left open are implicitly closed by a RUN coimand 
or by any command that modifies the program buffer, such as DELETE, 
LOAD or line insertion change. 

5.22.1.4 ENDPAGE filenumber 
25 ENDPAGE 7 

28 ENDPAGE R6 

The ENDPAGE statement is related to the ENDPAGE option described in 
section 5.22.1.1. However, it is syntactically and functionally 
distinct. Its function is to end the current output page of the 
designated filenumber and thereby position the output device to the 
beginning of the next logical page. The filenumber must be a numeric 
expression with a value in the range 0-9. When the ENDPAGE state- 
ment is executed the current value of the lines per page counter 
associated with filenumber is subtracted from its limit value. The 
result determines the number of empty lines which are output to the 
file device to complete the current logical page. When the ENDPAGE 
statement is complete the associated lines per page counter is reset 
to mark the beginning of the next logical page. 

5.22.1.5 ASSIGN (physical device number, logical stream indicator, device 
width, null count) 

10 ASSIGN (2,1,80,6) 
20 ASSIGN (2,2,132) 
3d ASSIGN (1,1) 

The ASSIGN statement is a dual purpose statement which provides the 
ability to specify the connections of physical output print devices 
to logical output streams and the values for carriage width and 
null count of the referenced physical device. The physical device 
number must be a numeric expression which evaluates to a 1 or a 2. 
The logical stream indicator must be a numeric expression which 
evaluates to a 1, 2 or 3. The device width and nullcount must be 
numeric expressions with values in the range 1 - 255. They are 
optional parameters in the ASSIGN statement. If they are not in- 
cluded, the values corresponding to the referenced physical device 
are not changed. If only the device width is included, then the 
nullcount is left unchanged. Note however that specifying a null- 
count requires that a device width also be specified, i.e., if the 
staten«nt only contains three arguments, the third will always be 
treated as a device width. 

Logical output stream number 1 consists of all output generated by 
.system messages, keyboard echoing, PRINT statements, LIST coimiands, 
and PUT statements when the corresponding filenumber is open to *T. 
Logical output stream 2 consists of all output generated by LISTP 
commands and by PUT statements when the corresponding filenumber is 
open to *P. The logical streai Indicator may be set to a value of 
3 to represent both logical output streams 1 and 2. 
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Physical device number 1 represents the display element of the 
keyboard display device that 1s configured as the system terminal, 
(see section 3.3.1 on terminal configuration). Physical device 
number 2 represents the hard copy print device which Is configured 
as the system printer, (see section 3.3.4). 

The output of a logical stream Is directed to all physical devices 
which are assigned to it. A physical device may be assigned to 
one or both logical streams. Whenever a physical device Is ASSIGNed 
Its previous assignment state Is effectively cancelled. A list of 
legal device connections follows: 

ASSIGN (1,1) - connects terminal display to stream 1 only 

ASSIGN (1,2) - connects terminal display to stream 2 only 

ASSIGN (1,3) - connects terminal display to stream 1 and 

stream 2 

ASSIGN (2,1) - connects printer to stream 1 only 

ASSIGN (2,2) - connects printer to stream 2 only 

ASSIGN (2,3) - connects printer to stream 1 and stream 2 

In Its initialized state BASIC connects the terminal to stream 1 
only and the printer to stream 2 only. This state can be restored 
by executing an ASSIGN (1,1) followed by an ASSIGN (2,2). 

When the terminal and printer devices are configured each device 
has a carriage width and a null count parameter associated with It. 
These parameters may be altered under program control by specifying 
optional 3rd and 4th arguments In an appropriate ASSIGN statement. 
The width parameter determines the maximum number of spaces on each 
line for the given device. When a line 1s output that Is longer 
than width the autowrap feature Is activated and a carriage return 
line feed is inserted between character number width and width +1. 
The autowrap feature may be disabled at configuration time. The 
width parameter may be changed on a given device by restating the 
current device asslgnirent with a new width argument. For example. 
If the terminal were currently assigned to stream 1 with a width 
of 80, it could be changed to a width of 72 with the statement 
ASSIGN (1,1,72). Note that any such change remains in effect until 
a subsequent ASSIGN statement alters it or until the system Is re- 
loaded. The nullcount parameter is one greater than the number of 
nulls which are output after each carriage return output to a given 
device. It is Important with unbuffered character serial devices 
which may lose characters while the carriage 1s being returned. 
ThenUlcount parameter for a given device may be dynamically changed 
by restating the current device assignment and WIDTH with a new 
nullcount. For example, if the printer were currently assigned to 
stream 2, 132 columns, no nulls (nullcount = 1), it could be changed 
to stream 2, 132 columns, 5 nulls by using the statement ASSIGN 
(2,2,132,6). 
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Because BASIC Is an interactive language It depends on the avatl- 
ability of a display device for system jnessages and keyboard 
echoing. An Interlock is therefore built 1n to ensure that stream 
1 always has at least one device assigned to it. If an ASSIGN state- 
ment is processed the result of which would violate this condition, 
then physical device 1 is automatically assigned to stream 1 as part 
of the ASSISN being processed. 

5.22.1.6 LISTP X - Y 

LISTP 

LISTP 10 

LISTP -10 

LISTP 10- 

LISTP 10-100 

The LISTP command causes a listing of the program in the current 
program buffer to be directed to logical output stream 2 which is 
normally connected with the system printer. This COMMAND Is anal- 
ogous to the LIST corranand (see section 5,5) with two exceptions. 
The LIST command directs its output to logical stream 1 which is 
normally connected to the system terminal display. The LISTP 
command outputs a paginated. listing with three blank lines at the 
top and bottom of each page and 60 lines of listing as standard, 
(see 5.22.1.7). 

X and Y must be legal linenuraber constants. 

LISTP prints the entire program buffer. 

LISTP X prints only line X if present or the first line greater than 
X if no line X exists. 

LISTP X- prints all lines starting with 1 or the first greater than 
X through the end of the program buffer. 

LISTP -Y prints from the beginning of program buffer thru line Y or 
the first greater than Y. 

LISTP X-Y prints from line X or first greater than X through line Y 
or first greater than Y. 

5.22.1.7 PAGESIZE numeric expression 

PAGESIZE 42 

The PAGESIZE coninand is related to the LISTP command. It causes the 
number of lines of listing per page of the LISTP command to be set 
to the value of the numeric expression in the PAGESIZE statement. 
This number is the number of actually printed lines not including the 
3 blank lines at the top and bottom of each page. For example, to 
list a program on paper which holds 48 lines per page, the statement 
PAGESIZE 42 would be the proper value to use. When BASIC is config- 
ured the default value for this parameter is 60. 
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NOTE that the PAGESIZE statement as described here Is syntacttcally 
and functionally distinct from the PAGESIZE option of the OPEN 
statement as described In 5.22,1.1 

5 . 22 . 2 Notes On Printer Related Programming 

Used properly and with care the printer related language features in 
Hicropolis BASIC provide for highly flexible and efficient programming 
of many common print file related functions. This section provides some 
examples and commentary. 

5.22.2.1 Separating Print Files and Interactive Messages 

There is a large variety of applications which can be programmed tn 
the following three part structure: 

1) Output to the terminal display a sequence of prompting 
messages which lead the user through a process of entering 
variable data from the terminal keyboard. 

2) Process the input data through algorithms which create de- 
sired output data. 

3) Output to the printer one or more pages which present the 
desired output data with proper labelling in an appropriate 
report format. 

This structure requires the ability to separate output which 1s 
normally intended for the operators terminal from output which' is 
normally Intended for the system printer. In Hicropolis BASIC the 
separation may be accomplished by using PRINT statements for terminal 
display messages and PUT statements to open print files for system 
printer output. The technique is illustrated by the following program 
for building a depreciation schedule chart. 
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100 

no 

1£0 
130 
140 
150 
160 
170 
ISO 
190 
200 
£10 
300 
310 

3a 

330 
340 
350 
360 
370 
3S0 
400 
410 
4£0 
430 
440 
450 
460 
470 
4S0 
490 
500 
510 



! ♦♦♦ DftTFl IMPUT SECTION 

PRINT "THIS PRD6RW1 WILL EUILB ft DEPFECIFlTIDH SCHEDULE" 

PRINT " SHOWING YEfiR BY YEAR DEPRECIflTIDN DF ft FIKED hSSET" 

PRINT "AT STRAIGHT LINE AND 200'i RCCELERATED RATES." 

PRINT 

PRINT "PLEASE ENTER ASSET VALUE " > 

INPUT A 

PRINT "PLEASE ENTER TERM IN YEARS"; 

INPUT T 

PRINT "PLEASE ENTER FIRST YEAR DF TERM (EG. 1977>"; 

INPUT Y 

♦♦♦ PRINT OUT CHART HEADINGS 

OPEN 9 "♦P" 

PUT 9! PUT 9 

PUT 9 "DEPRECIATION SCHEDULE FDR S ";A;" OVER "JT!" YEAR (S) 

PUT 91 PUT 9 

PUT 9" YEAR", "ST. LN. DEP. ", "BALANCE" > "20 OJ; DEP. " n "BALANCE" 

PUT 9 
I 

! ♦♦♦ COMPUTE AND PRINT EACH LINE 
I 

B 1 =A s B2=A : S=A^T : FS= " SZZZZ22V . 99 " 

FOR K^ITOT 

B1=B1-S 

D=2*B2/T 

E2=B2-D 

PUT 9 YpFMT<:S»FS> ,FMT<B1.FS> ,FMT -rDr. F$> , FMT <B2, F«> 

YsY+1 

NEXT K 

CLOSE 9 

END 
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RUM 

THIS PRQGRfiM WILL BUILD ft DEPRECIftTIDM SCHEDULE 
SHQWIN6 YEAR BY YEfiP DEPRECIATIDH OF ft FIKED FiSSET 
RT STRfllGHT LINE FlMD aOOZ BCCELERflTED R«TES. 



PLEASE ENTER 
PLEASE EMTER 
PLEASE ENTER 



ASSET VALUE ? 100000 

TERM IN YEARS? 25 
FIRST YEAR OF TERM <EG. 



1S1 



1 98 



DEPRECIATIDN SCHEDULE FOR S 100000 OVER £5 YEARtS) 



YEAR 

1930 
1931 

1982 
19S3 
1984 
1985 
1986 
198? 

1989 
1990 
1991 

1992 
1993 
1994 
1995 

1996 

1 997 

1 998 

1 999 

a 000 

2001 
2002 
2003 
2004 



ST 


. LN. DEP. 


BALANCE 




£00'i DEP. 


BALANCE 


S 


4000. 00 


S 


96000. 


00 


s 


8000. 00 


■s 


92 000. 


'S 


4000. 00 


•B 


92000. 


00 


s 


7360. 00 


s 


8464 0. 


s 


4000. 00 


S 


8S000. 


00 


s 


6771.2 


s 


77368.8 


s 


4000. 00 


$ 


84 000. 


00 


$ 


6229.50 


$ 


71639.29 


s 


4000. 00 


$ 


30000. 


00 


s 


5731. 14 


■i 


659 08. 15 


s 


4000. 00 


$ 


76000, 


00 


$ 


52F2.65 


:£ 


60635.5 


•i 


4000. 00 


$ 


72000. 


00 


s 


435 . 84 


■B 


55784.66 


s 


4000. 00 


$ 


68000. 


00 


■i 


4462.77 


S 


51321.88 


s 


4000.00 


« 


64000. 


00 


s 


4105.75 


S 


47216. 13 


s 


4000. 00 


:B 


60000. 


00 


s 


3777.29 


s 


43438.84 


s 


4000. 00 


t 


56 . 


00 


■i 


3475 . 1 


■£ 


39963.7- 


t 


4000. 00 


S 


52000; 


00 


:B 


3197. 09 


'£ 


36766. 6.. 


s 


4000.00 


S 


48 000. 


00 


s 


294 1 . 3:3 


■B 


3382=: 3C 


$ 


4000. 00 


* 


44000. 





$ 


2706. 02 


•i 


311? 8 


s 


4000. 00 


* 


40000. 


00 


4 


2489.54 


S 


2S6c 3 


■$ 


4000. 00 


s 


36000. 


00 


'$ 


£290,37 


■B 


£6339.36 


$ 


4000. 00 


s 


32000. 





S 


£107. 14 


■i. 


24£3£.£l 


■J 


4 000. 00 


« 


28000. 





■i; 


1938.57 


•B' 


££293.63 


s 


4000. 00 


s 


£4000. 


00 


s 


1?S3.49 


:B 


£0510. 14 


s 


4000. 00 


■i 


£0000. 


00 


:| 


lfc.40.Sl 


•B 


13369.33 


s 


4000. 00 


* 


16000. 


00 


S 


1509.54 


S 


17359.78 


■B 


4000.00 


$ 


12000. 


00 


■i. 


1 388 . 73 


■i 


15971, 


s 


4 . 


$ 


8000. 


00 


s 


1277.68 


•B 


14693. 3£ 


■$ 


4000. 00 


s 


4000. 


00 


s- 


1175.46 


;| 


13517.85 


s 


4000. 00 


:£ 


• 





« 


1031.42 


■B 


1£436.4£ 



READY 
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5.22.2.2 Paginating Print Files 

When the number of lines tn a print file spans several printed 
pages It Is often required to print the file with page numbers, 
headings and an equal number of lines on each page. The ENDPAGE 
statement and the PAGESIZE and ENDPAGE options of the OPEN statement 
provide a useful set of tools for accomplishing this goal. The 
following example shows the depreciation schedule program of section 
5.22.2.1 modified to print on 2? line pages with each page numbered 
and titled. Note the use of the PAGESIZE and ENDPAGE options 1n 
Hne 320 in conjunction with the page heading subroutine at Hne 600. 
NOTE also the use of the ENDPAGE statement in line 510 which ejects 
the last report page and leaves the printer at the top of the next 
blank page. 
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100 i ♦♦♦ DRTFi INPUT SECTION 

110 ! 

laO PRIhT "THIS PRDGRftM WILL BUILD ft DEPREC IfiTIDN SCHEDULE" 

130 PRINT "SHDUIING YEftR BV VEflR DEPRECIfiTIDN DF ft FIKED ASSET" 

140 PRINT "ftT STRAIGHT LINE RND £00*i FiCCELERftTED RATES. ■' 

150 PRINT 

160 PRINT "PLEhSE ENTER ASSET VALUE "I 

170 INPUT A 

ISO PRINT "PLEASE ENTER TERM IN YEARS"? 

190 INPUT T 

EOO PRINT "PLEASE ENTER fIRST YEAR DF TERM iEG. 197?>"; 

£10 INPUT Y 

300 ! 

305 ! ♦♦♦ OUTPUT INITIALIZATION 

310 ! 

3a OPEN 9 "♦P" PASES 1 2E £0 ENDPAGE 600 

330 P=lsGDSUB oOO 

34 B 1 = A : B£«A ; S=M/T s F$= " $222222V . 99 " 

400 ! 

410 ! ♦♦♦ COMPUTE AND PRINT EACH LINE 

420 ! 

440 FOR K=lTnT 

450 El=Bl-S 

460 D=2*B£/T 

470 B£=B2-D 

4150 PUT 9 Y.FHT<S..F$> !.FMT<B1»FS>»FMT'::D»FS>»FMT<B£'..F*;) 

490 Y=y+i 

500 NEXT K 

510 ENDPRGE 9 J CLOSE 9 

520 STOP 

600 t 

610 ! ♦♦♦ PAGE HEADING SUBROUTINE 

620 ! 

630 PUT 9 

640 PUT 9 TAB <72>; "PAGE ";P 

650 PUT 9 

660 PUT 9 "DEPRECIATION SCHEDULE FDR S "SAJ" OVER "IT?" YEAR <S> 

670 PUT 9! PUT 9 

675 PUT 9" YEAR"!. "ST. LN. DEP. "j "BALANCE" » "20 OJ-i DEP. "» "BALANCE" 

677 PUT 9 

700 P=P-t-i 

710 RETIJRN 

999 END 
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REftDY 

RUN 

THIS PRD6Rl=lM WILL BUILD fi DEPRECIflTIDH SCHEDULE 

SHOWING YEAR BY YEftR DEPRECIflTIDN DF fi FIKED ASSET 

RT STRAIGHT LINE AND 2iJ0r< ACCELERATED RATES. 



•■•LEflSE ENTER ASSET VALUE ? 100000 
i^LEASE ENTER TERM IN YEARS? 25 
PLEASE ENTER FIRST YEAR OF TERM <Eb, 



19J 



1 98 



PAGE 1 



DEPRECIATIDN SCHEDULE FDR S 100000 OVER 



YEAR 

1980 
1981 
1982 
1983 
1984 
1985 
1986 
1 987 
f98S 
1989 
1990 
1991 



ST. LN. DEP. 



s 


4000. 


00 


s 


4000. 


00 


s 


4000. 


00 


s 


4000, 


00 


s 


4000. 


00 


s 


4000. 


00 


s 


4000. 


00 


s 


4000. 


00 


s 


4000. 


00 


$ 


4 000, 


00 


s 


4000. 


00 


$ 


4000. 


00 



BALANCE 



$ 
S 
$ 

S 

s 
$ 
s 
$ 
$ 
f 
$ 



96000. 00 
92000. 00 
88000. 00 
84000. 00 
8000 0. 00 
76000. 00 
72000. 00 
68000. 00 
64000. 00 
60000. 00 
56000. 00 
52000. 00 



r"EAR <:S.) 


200J: DEP, 


f. 


8000. 00 


:|; 


7360.00 


s 


6771.20 


•t 


6229.50 


$ 


5731. 14 


:i 


5272.65 


$ 


4850.84 


s 


4462,77 


$ 


4105.75 


s 


3777.29 


$ 


3475. 10 


f. 


3197.09 



BALANCE 




S 


92000. 





$ 


84640. 





s 


77868. 


8 


s 


71639. 


29 


$ 


65908. 


15 


$ 


60635. 


5 


•i 


55784. 


66 


s 


51321. 


88 


$ 


47216. 


13 


s 


43438. 


84 


s 


39963 . 


73 


s 


36766. 


63 



PAGE £ 



ED* 


JLE FDR ;B 


10 0000 OVER £5 


YEAR <S> 






ST 


. LN. DEP. 


BALANCE 


£0 


■J': DEP. 


BALANCE 


S 


4000. 00 


$ 


48000,00 


S 


£94 1 . 33 


S 


33825 . 3 


S 


4000.00 


S 


44000.00 


S 


2706, 02 


s 


31119.28 


$ 


4000.00 


S 


40000.00 


S 


2489 . 54 


s 


£8629.73 


S 


4000. 00 


$ 


36000. 00 


s 


2290.37 


t 


26339.36 


S 


4000.00 


S 


32000. 00 


$ 


2107.14 


s 


24232. £1 


S 


4000.00 


$ 


28000.00 


•i. 


1938.57 


s 


22293.63 


S 


4000.00 


S 


2400 0.00 


$ 


1783.49 


s 


£0510. 14 


S 


4000.00 


$ 


20000.00 


s 


1640.81 


s 


18869.33 


$ 


4000.00 


f 


16000,00 


'$ 


1509.54 


s 


17359.78 


S 


4000, 00 


S 


12000.00 


s 


1388.78 


s 


15971.00 


■B 


4000. 00 


S 


8000. 00 


s 


1277.68 


s 


14693.32 


S 


4000. 00 


$ 


4000.00 


s 


1175,46 


s 


13517.85 



YEAR 

1992 
1993 
1994 
1995 
1996 
1997 
1998 
1999 
2000 
2001 
2 02 
2003 



DEPRECIflTIDN SCHEDULE FDR $ 100000 OVER 25 YEAR<S-;. 



PAGE 



YEAR 
2004 



ST. LN. DEP. 
$ 4000.00 



BALANCE 

S . 00 



£0 0": DuP. 
S 1 03 1 . 42 



BALANCE 

S 12436.42 
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5.22.2.3 Spooling Print Files To Disk For Later Output 

The commonality of the OPEN, CLOSE and PUT statements to both disk 
and print files makes it possible to alter a print file program so 
that the output is saved in a disk file instead of sent to the printer. 
The procedure is to change the filename in the relevant OPEN statement 
from "*P" to some appropriate disk filename. For example, line 320 
1n the depreciation program listing might be changed to 

320 OPEN 9 "N:OEP -REPORT" PAGES I ZE 23 ENDPA6E 600 

A print file that has been spooled to disk in this manner can be 
printed out at a later time by using the following program: 

5 INPUT "ENTER PAGE WIDTH OF FILE TO 8E PRINTED" -.A 

10 DIM AS(A) 

20 STRING CHARS(16RFF) 

30 INPUT "ENTER NAME OF FILE TO BE PRINTED" ;AS 

40 OPEN 1 AS END 90 

50 OPEN 2 "*P" 

60 GET 1 AS 

70 PUT 2 AS 

80 GOTO 60 

90 CLOSE 1 

W CLOSE 2 

110 END 

Note that the string into which each disk record is read must be 
dimensioned to a length which matches the expected page width of 
the report (lines 5 and 10). This ensures that the extra blank 
padding that fills each disk record will not be printed out causing 
extra blanks lines on most printers. 

Note also that line 20 changes the system string delimiter to a 
value that is illegal 1n normal print files. This ensures that the 
entire content of each line will be assigned to and printed from AS 
regardless of which characters appear in the print file. If this 
were not done any commas in the print file would cause erroneous 
output. 

5.22.2.4 Draining File Output To A Null Device 

During the program development and test process or in a reduced 
system hardware environment it is sometimes useful to ryn a program 
which outputs one or more files and be able to suppress one or more 
of the output files while the rest of the program runs normally. 
In Micropolis BASIC this is easily accomplished by changing the 
filename in the open statement of each file to be suppressed to a 
"*N". When the program is run all output to "*N" files will be 
suppressed or drained away without other-^ise affecting program 
operation. The following program illustrates this idea. 
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13 DIM AS(4,2a) 

2g FOR J»l TO 4:AS(J)»"":N£:(T J 
3(if INPUT " FIRST LINE ";AS(1) 
iH INPUT "SECOND LINE ";AS(2) 

53 INPUT " THIRD LINE "•,A$(3) 

6a INPUT "FOURTH LINE ";A$(4) 

73 aS="LABELS" 

30 INPUT "ADO TO DISK FILE (Y/N)";XS 

n IF XS »"Y" THEN 3S*"-iN" 

113 INPUT "PRINT LASEl (Y/.N)";X$ 
123 IF XS= "Y" THEN CS«"*N" 
13f XS-"," 

■u 1 as 

|+XS+AS(2)+X$+AS(3)+X$-i-AS{4)+AS 
4: PUT 2 A$(J):NEXT J 



The file output section attempts to add four lines of input to a 
label file and then print a copy of the new label entry. If either 
or both of these functions is refused by the operator during the 
input section, the progran chances the filenaine variable for the 
associated OPEaN statement to "*N". When the output section tx€- 
cutas the refused function output is simply drained, i.e. not 
output anywhere. 



143 OPEN 1 B$ 


159 PUT 1 A5(l 


16a CLOSE 1 


170 OPEN 2 CS 


lag FOR j»i TO 


19a CLOSE 2 


208 GOTO 29 



3.22.2.5 Echoing Of Terminal Output To Printar 

On systems with a video tsnninal and printer device it is often 
desirable to obtain a hard copy audit trail of all syscen program 
operation, including all of the prompts and systam messages norrnally 
directed to the tenainal only. This is easily done by using the 
stateTOnt 

ASSIGN (2.3). 

Tnis statement causes the hard copy printer ta be connected tc logical 
output stream 1 which includes all print stataiients, input dialogue, 
keyboard echoing, *T files, and systs-Ti aessages; and to logical out- 
put stream 2 which includes all *P print files. Thus everything 
aimed at the tanninal thru stream 1 will also go to the printsr. 

This echo mode remains active until changed. The stataaent ASSIGN 
(2,2) will restore the sys-am lo nonral wnich is device 1 

(terminal) connected to stream 1 and device 2 (printer) connected to 
stream 2. 
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VI. DISK SUBSYSTEM THEORY AND DIRECT PROGRAMMING 



6.0 INTRODUCTION 

This section describes the Micropolls flexible disk, subsystem In 
sufficient detail to enable an experienced 8080 assembly language 
progranmer to implement a disk driver. 



6.1 FUNDAMENTALS OF THE FLEXIBLE DISK: MEDIA 

6.1.1 Recording Medium 

The recording medium used with the Micropolis flexible disk 
subsystem is illustrated in Figure 6.1. The medium consists 
of a thin, oxide coated circular disk permanently housed in 
a protective plastic jacket. The disk rotates freely within 
the jacket, which is lined with a material that cleans the 
disk as it rotates. Several holes in the plastic jacket 
allow a disk drive to access the disk. When a diskette is 
loaded into a drive, the disk is clamped to a motor -driven 
spindle through the drive spindle hole. The read/write head 
and the load pad which nresses the disk against the head, 
access the disk through the read/write head access holes. 
A photo detector senses sector and index holes through the 
sector/index hole. A switch in the disk drive senses the 
Write Protect cutout. If a Write Protect tab is placed 
over the cutout, the diskette may be read, but may not be 
written on. If the cutout is open, both read and write 
operations may be performed. 

6-l'2 Disk Data Format 

Figure 6.2 illustrates the format of data recorded on the 
diskette. Data is recorded on the diskette on concentric 
tracks. The outermost track is Track and the innermost 
track is 76 in Mod II subsystems and Track 34 in Mod I 
subsystems. Each track has an unformatted capacity of 
6250 bytes. Disk data transfers are performed on a block 
basis, which would require a 6250 byte RAM buffer in the 
computer for a full track size block. This buffer size 
is wasteful of memory, so the actual format used divides 
a track into blocks of more manageable size called sectors. 
Ihe format used in the Micropolis flexible disk subsystem 
divides each track into 16 sectors. The beginning of each 
sector is indicated by a sector hole punched in the disk. 
This hole is sensed by a sector /index sensor in the disk 
drive. An index hole is located halfway between the holes 
for sector 15 and sector and indicates the next hole is 
sector 0. 
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Each sector has an unformatted caoacity of anproximately 390 
bytes. However, not all of the available storage space can be 
used for data. The electronics in the disk drive and the nature 
of the media and drive mechanism require a certain amount of 
space be given up to accommodate the electronic characteristics 
and to allow sufficient tolerance in the recording format to 
permit interchanging diskettes between different disk drives. 
Briefly, the factors which must be taken into account are: 
mechanical tolerance in the physical distance between sector 
holes punched in the disk; alignment of the sector/index sensor 
with respect to the read/write head; response of the sector/ 
index sensor and logic; disk speed variation; write clock 
frequency tolerance; and, acquisition time of the read data 
decoder. 

The recommended sector format is illustrated in Figure 6.2. 
This is the format used in disk files created by the Micropolis 
Disk Extended BASIC software and is the format required by the 
disk bootstrap located on the controller board. This format 
was designed to make the best trade-off between storage capacity 
and tolerance margins. Although other formats could possibly 
utilize more storage capacity, they would be incompatible with 
the bootstrap and a complete discussion of the engineering 
considerations necessary to design another format is beyond 
the scope of this section. 

A disk sector consists of the following fields: 

^^ preamble ; The preamble Is composed of anproximately 40 bytes 
of zero (0) data bits. The preamble is automatically generated 
by the disk controller and is necessary to provide tolerance 
for the mechanical alignment and electrical characteristics 
of the sector/index sensor. It also provides a field of known 
data pattern for synchronization of the read data decoder. 

2) Sync : The sync byte is a byte of 0FFH data which is used in 
the disk controller to define the beginning of useful data. 

3) Header : ' The header is a 2 byte block consisting of the binary 
track address of the track on which the sector resides (0-76 (34)) 
and the address of the sector (0-15). The header is used to 
verify that the proper sector Is being accessed in a disk I/O 
operation. 

4) Data ; The data field consists of 266 bytes of user data. 

5) Checksum : The checksum is a one byte error detection code which 
provides error detection in read operations. The checksum is 
computed as follows: a) The accumulator and carry are initially 
cleared; b) Each byte of the header and data fields is added to 

the accumulator with carry. In write operations, the computed 
checksum Is written immediately following the data field. In 
read operations, the checksum is re-computed from the read data 
and is compared with the checksum byte which is read. If they 
do not compare, a read error has occurred. 
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^) Postamble ; The rest of a sector froo the checksum to the next 
sector hole is filled with zero data bits. The length of the 
postatnble allows for the mechanical tolerance in the placement 
of sector holes on the disk, and tolerance for disk speed and 
write clock variations. 

"6.2 HARDWARE FUNDAMENTALS 

Figure 6.3 is a block diagram of the Micropolis flexible disk 
subsystem. The components of the subsystem may be grouped as: 
spindle drive control; sector logic; position control logic; 
read/write logic; select and head load logic. 

1) Spindle Drive Control ; The disk drive spindle motor is 
controlled by a micro-switch tha-t senses when the diskette 
is inserted and loaded, or unloaded. When the diskette is 
loaded, the disk is accelerated to a speed of 300 RPM. 
After an appropriate delay to allow the speed to stabilize, 
the drive is ready to accept commands. If the drive is 
selected by the controller, the drive will indicate this 
state by asserting ready status. 

2) Sector Logic ; When the disk is rotating, the sector/Index 
hole sensor provides the controller with an electrical pulse 
corresponding to each hole punched in the disk. The controller 
separates the sector and index pulses and counts the sector 
pulses,, thereby providing the progransner with the 4 bit address 
of the sector currently passing under the read /write head. A 
flag bit in the status register is provided to indicate when 
the sector address is valid and when a read or write operation 
may be initiated. 

3) Position Control Logic ; The read/write head Is mounted on, a 
carriage which is moved from track to track by a. stepper 
motor-driven lead screw. Positioning is accomplished by 
specifying the desired direction (in or out) and issuing 

a step conmand. Control logic in the drive electronics 
generates all the signals necessary to cause the motor to 
move a track in the desired direction. When a drive is 
first selected, such as at power on, the track position of 
the drive is indeterminate. Before read or write operations 
may be performed, the positioner must be recalibrated as 
follows: when the carriage is positioned at track 0, a 
microswttch associated with the positioning mechanism is 
made. The state of this "track 0" switch is provided as 
a status bit. Recalibration consists of examining the 
track status and if it is not true, issuing a command to 
step out, . After an appropriate delay to allow the comnand 
to be executed, the process is repeated. Once the positioner 
has been calibrated, the software must -keep track of the 
current position. 
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4) Read /Write Logic ; Data is transferred between the computer 
and the controller on a byte-fay-byte basis. For write 
operations, the controller generates the preanile and then 
converts 8-bit byte data from the computer to the serial 
data which is recorded on the disk. When the computer 
stops supplying data, the controller automatically writes 
zero data to the rest of the sector until a sector pulse 
is sensed. For read operations, the controller converts 
the serial data stream coming from the disk to 8 -bit bytes 
and autotna tic ally detects the sync byte to determine when 
valid data is available. 

The controller generates a "transfer ready" status flag 
which indicates that the controller is ready to accept 
data in a write operation, or that data is available in 
a read operation. 

The controller is accessed using a technique called 
"memory -mapped I/O". This means that the controller 
command, status and data registers are treated as 
memory addresses and that controller read/write consnands 
are actually rtKmory reference instructions. When the 
controller data register is accessed in a read or write 
operation, the controller forces the computer to wait 
until the controller is ready to transfer data. From 
the computer's point of view, the controller appears to 
be slow memory. 

The read/write control logic in the drive electronics 
provides the conversion between the serial digital data 
at the controller interface and the serial data signals 
at the read/write head. Whenever the drive is performing 
a write operation, the positioner control and read logic 
is disabled and the appropriate signals are generated to 
drive the read/write and erase heads. The erase head used 
in flexible disk drives is a "trim" erase head. Old data 
written on a sector is implicitly erased by being written 
over by new data. However, any slight track positioning 
errors could cause sufficient remnant old data to be left 
in the space between tracks to cause data reliability 
problems. To eliminate this error source, an erase head 
which erases the disk a snail distance on either side of 
the newly written data is provided. This erase head is 
located a small distance behind the read/write head and 
cleans up the inter-track gap after data is written. 

When a write operation is terminated by the occurrence of 
a sector pulse, the erase head is left on a sufficient 
amount of time for the last data written to be trinmed. 
Since the position control and read logic will be inhibited 
until the write operation is complete (including the erase), 
a new operation must not be attempted for at least one 
millisecond after the termination of a write operation. 
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The drive contains a raicroswitch which senses the write 
protect cutout in the diskette jacket. When the write 
protect tab is installed, the write/erase control logic 
is inhibited. The state of the write protect switch is 
available as a status bit. 

5) Select and Head Load Logic ; The controller will support 
up to 4 disk drive units connected in a "daisy chain" 
configuration. The drive electronics in each unit are 
conditioned by the drive select such that only one drive 
at a time will respond to, or provide, signals on the 
controller /drive interface. When a drive is not selected, 
the spring- loaded pressure pad which holds the disk in 
contact with the read/write head is moved away so that there 
is no contact and the head is "unloaded". When the drive is 
selected, a solenoid is energized, which allows the load pad 
to contact the disk so read or write operations may be 
performed. The controller contains a 4-second timer which 
automatically deselects all units if the controller has not 
been accessed for four seconds. 



6.3 CONTROLLER REGISTERS 

The disk controller occupies a IK byte block of memory from F400H to F7FiH. 
The first half (F400H to ISTFR) is reserved for on-board bootstrap ROM. The 
controller command, status and data registers start at address F600H and are 
defined as follows: 

1) Output Registers 

Command Register 

F600H or 
P601H 



7 6 -i 


4 12 


1 n 


COMMAND 
CODE 


kV. ..-. 


MOD 



MOD » Command Modifier 

The commands available are: 

Code Command Modifier 



001 
010 

011 

100 
101 



Select drive 

Set interrupt enable 
(controls sector 

pulse interrupt) 

Step 1 track 



Enable write 
Reset controller 



Contains drive unit address (0-3) 

01 = enable interrupt 

00 = disable interrupt 



00 = step out 

01 = step In 

Not used 
Not used 
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Write Data Register 

F602H If the write data register is referenced when the 
transfer flag is set during a write operation, the 
controller expects a data byte to be on the S100 
buss data lines. The PRDY line will be held false 
until the controller has accepted the data, then 
the PRDY line will be set true for 1 bit time 
(4 usee). (See the status register description 
for the defiaitioa of the transfer flag,) 



2) Input Registers 
Sector Register 
F600H 



Bits 



i S 
! G 

I T 

is. 

u 

I L 
G. 



I 
M 

T. 

F 

L 
G. 



4 


3 


2 1 


i 






SECTOR 








ADDRESS 


I 
! 

! 



J_ 



// 



Definition 
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Sector Address : Address of the sector currently- 
passing under the read /write head of the selected 
drive. 



4,5 
6 



Reserved. 

Sector Interrupt Flag ; Indicates an interrupt 
request has been generated by a sector pulse. 
Flag is reset by issuing a reset or an interrupt' 
disable command. 



Sector Flag ; Indicates the sector address is 
valid and that a read or write operation may be 
performed. Flag Is true for 30 usee at the start 
of each sector. All data transfers must be 
Initiated within 100 u seconds of the flag going 
true. 



Status Register 
F601H 
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I 
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~R 
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Bits Definition 



0-1 Unit Address ; Address of the currently selected 

drive. Address is valid only if SLTD is true. 

2 SLTD ; Unit selected. This flag is low true, 
i.e., 

= Selected 

1 = Not selected 

SLTD is true if a drive has been selected and 
the 4-second timer has not expired. SLTD is 
low true so that the software may detect when 
the controller is not installed (non-existent 
memory references yield 0FFH) . 

3 TK0 : Track status from selected drive. 

4 WPT ; Write protected status from selected drive. 

5 READY : Ready status from the selected drive. 
When true, indicates the drive is ready to 
perform commands. 

6 PINTE : PINTS status from the S100 BUSS. 

7 XFER FLAG ; Transfer flag. In write operations, 
indicates that the controller is ready to accept 
data from the computer. In read operations, 
indicates the controller has data available to 
the computer. When the software detects the 
transfer flag has set, all data transfers are 
performed by accessing the controller data 
register, which automatically synchronizes the 
transfer by use of the PRDY line. 

Read Data Reg later 

F602H If the read data register is accessed when the transfer flag is 
set during a read operation, the controller will hold the PRDY 
line false until s byte of data is available. The controller 
will then place the data on the S100 BUSS data lines and set 
PRDY true for 1 bit time (4 usee). The data will only be 
available for this 1 bit time period. 
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6.4 DISK OPEMTIONS 

Hie following paragraphs describe 'in detail the steps involved in performing 
each of the operations required to operate the Micropolis flexible disk drive 
subsystem. 

6.4.1 Select a Drive 

A drive laist be selected prior to any status read, step or data transfer 
operation. Selection must be performed for each operation since the 4 
second timer nsay have deselected a unit since it was last accessed. The 
important considerations in selecting a drive aret 

1) When the drive is selected, the head will be loaded. A 

minimum of 75 milliseconds inust be allowed for the head 
to load and settle. 

2) "ae sector counter is located in the controller. When a 

drive is selected, a minimum of 250 milliseconds must be 
allowed for the sector counter to synchronize to the drive. 

Figure 6.4 is a flowchart of the select operation. 

NOTE that all delays are generated by a software timing loop 
subroutine. A read status command is included to re-trigger 
the 4 second timer every time the delay routine is entered. 

6.4.2 Position the Head 

A drive must be selected before a step command can be issued to cause 
the head to move 1 track. One step command of the appropriate direction 
(in or out) naist be issued for each track moved, A minimum delay of 30 
milliseconds must be allowed between each step command. (Note a step 
in moves the head toward the center of the disk and therefore to 'a higher 
track number.) Typical logic to implement a 1 track step is illustrated 
in Figure 6,5. 

After the head is positioned to the desired track, an extra delay must be 
allowed for the head to settle before read/write operations are attempted. 
The complete process for an N track move is illustrated in Figure 6.6. 



6.4.3 Restore to Track 

When a drive is first selected, the position of the read/write head is 
indeterminate. Prior to performing disk data transfers, the positioner 
must be "recalibrated" which consists of stepping the head out until tne 
track switch is made. If the drive already indicates track status 
when first selected, the head is stepped in 8 tracks, then out to ensure 
a good track position. Once calibrated, the software must keep track of 
the current head position for each drive. The restore ]ngic recommended 
is illustrated in Figure 6.7. 
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Figure 6.5 
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Figure 6,7 
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6.4.4 Write Operation 

Figure 6.8 Illustrates the logic necessary to perform a sector write 
operation. The program Illustrated requires a 268 byte memory buffer 
with the first two bytes set to the track and sector address. The 
sync byte and checksum are generated in the program. The steps 
Involved In writing a sector are: 

1) Move the data to the write buffer, 

2) Select the drive. 

3) Wait for sector flag. When the flag goes true compare the 
sector address with the desired sector address. When the 
desired sector is found, issue an enable write conmiand. 

4) The enable write command causes the controller to generate 
the preamble. Wait for transfer ready flag to indicate the 
controller is ready to receive data. The software must then 
write the sync byte. The timing of the software loop which 
tests for XFER ready and then outputs the sync byte is 
extremely critical. The sync byte taist be on the SIM buss 
data lines within 32 usee after XFSH ready sets. The 
following code satisfies the timing requirements : 

(HL = F601H and A «» when this loop is entered) 

*Watt for XFER ready flag 

WAIT ORA M 

JP WAIT 
♦INSERT SYNC BYTE 

INX fl 

M7I H, 0FFH 

5) Each successive data byte must be made available wltnin 32 
useconds of the previous byte. When the data register Is 
accessed, the controller will hold PRDY false until it accepts 
the data and then allow PRBY to go true for 1 bit time. The 
timing constraints on the write loop are therefore a maxiimjm 
loop time of 32 useconds and a minimum loop time of 1 bit time 
(4 useconds). These figures do not include any margin for 
clock tolerance, so the actual design goals should be about 

28 and 6 useconds for a conservative design. 

6) When the checksum has been written, stop accessing the controller 
write register. The controller will automatically zero fill the 

rest of the sector, 

7) After the checksum is written, the program waits for the next 
sector flag. At this time the controller terminates the write 
operation and the erase delay in the drive starts. The 1 milli- 
second software delay allows sufficient time for the erase delay 
to expire so that step and read functions are again enabled. 
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6.4.5 Read Operation 

Figure 6.9 illustrates the logic necessary to perform a sector read 
operation. The program Illustrated requires a 268 byte read buffer. 
The track/sector ID will be read Into the first two bytes of the 
buffer and when the operation is complete, will be compared against 
the desired track/sector address. The steps Involved in reading a 
sector are: 

1) Select the drive. 

2) Walt for the sector flag. When the sector flag is true, 
compare the sector address with the desired sector. 

3) When the desired sector is found, wait for the transfer 
flag to set to Indicate disk data is available, lote 
that no conmand Is necessary to start a read operation, 
but you must always wait for a sector flag to Indicate 
the start of the read, 

4) When the transfer flag Is set, the sync byte will be 
available In 25-28 useconds. The sync byte will only 
be available for 3-4 useconds so the timing of the loop 
which checks for the transfer ready flag is critical. The 
following code satisfies the timing requirements: 

CHL =» f 6<J1H and A ■ when this loop is entered) 

* Wait for XFSR SCT flag 

WAIT ORA M 

JP WAIT 
*GOBBtS SmC BTEE 

WK H 

MOV A,M 

5) Bach successive data byte will be available within approxiaately 
25 useconda and will be available for about 3 useconds. 

When the controller data reglater is accessed, the 
controller will hold PR13Y false until the data la 
ready, then will place the data on the S100 buss data 
lines and allow PRDY to go true for 1 bit time. Once 
the software has read a byte. It maat not access the 
data register again until this bit time has expired. 
The timing constraints on the read loop are therefore 
a maximum loop time of 25 useconda and a minimum loop 
time of 5-6 useconds. These figures reflect a 
conservative margin to allow for timing variations 
In the disk read data. 

6) The last byte to be read from the disk Is the checksum. 
The checksum read should be compared with the re-computed 
checksum, to determine If a read error has occurred. 
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Figure 6.9 SECTOR READ 
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7) If no checksum error is detected, the first two bytes 
read should be compared with the desired track and 
sector addresses to ensure the correct sector was read. 

6.5 ERROR HANDLING 

An important consideration which may not be ignored in the design of a 
flexible disk driver is the handling of errors which occur. Magnetic 
storage devices in general are subject to errors. The succeptabllity 
of the diskette to damage or contamination due to handling makes error 
handling particularly important in flexible disk systems. Most errors 
are of a temporary nature and will be invisible to the system with a 
properly designed driver. 

Most errors can be attributed to one or more of the following sources: 

1) Transient Electrical Noise 

2) Media Contamination - Particles of foreign substances may- become 
lodged between the head and the recording surface of the disk and 
cause data errors. 

3) Head Positioning - The read write head may be positioned to the 
wrong track if the specified step rate is exceeded or may be 
marginally positioned if a drive is misadjusted. 

4) Disk Centering - Due to the flexible material of which the disk 
is constructed, or in the event the disk is damaged or distorted 
due to mis-handling, it is possible that a diskette may be 
improperly clamped to the spindle in the disk drive. 

The following procedures are recommended to perform proper error handling 
in disk read/write operations: 

Read Operations 

1) Step the positioner to the desired track. 

2) Perform the read operation as described in Section 6.9.5. If a 
header or checksum error occurs, re-read the sector up to 5 times, 

3) If the 5 retrys were unsuccessful, step the positioner off one 
track and then back to the desired track. Repeat Step 2. If 
still unsuccessful, step the positioner off one track in the 
other direction and then back. Repeat Step 2. 

4) Perform tne restep procedure given in Step 3 up to 4 times. If 
still unsuccessful, deselect the unit and wait about 200-milli- 
seconds for the head to unload. Res elect the unit, restore to 
track 0, and re-seek to the desired track. Repeat Steps 2 and 3. 

5) Perform the raselect function given in Step 4 up to 3 times. If 
still unsuccessful, abort the operation with a permanent I/O error, 
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Write Operation 

1) Step the positioner to the desired track. 

2) Read the sector immediately preceding the desired sector. Any 
errors which occur should be handled in the manner described 
for normal read operations. This operation ensures the head is 
properly positioned to the right track and the sector counter is 
synchronized with the disk. 

3) Write the desired sector as described in Section 6.4.4. 

4) Read the sector just written to ensure the data was recorded 
properly. If an error occurs, repeat Steps 2, 3, and 4 up to 5 times. 

5) If unsuccessful, perform fr e restep operation as described for the 
read operation and repeat Steps 2, 3, and 4. 

6) If 4 restep operations are unsuccessful, perform the reselect 

operation as described for the read operation. 

7) If 3 reselect operations are unsuccessful, abort the operation 
with a permanent I/O error. 

If a permanent I/O error occurs, the disk may be improperly centered, there 

may be a defect in or damage to the recording surface of the disk, or the 
disk nay have been written on a marginal drive. 

The "restep" procedure described takes advantage of the hysteresis present 
in all positioning systems. Friction in the positioner causes the head 
position to deviate slightly from the nominal track position. This position 
will be different when the head is stepped to a track from different directions. 
In normal operations, this slight position error is well within the tolerance 
limits for proper operations. However, if errors are encountered in reading 
a disk which was written on another drive that is marginally aligned, the 
slight difference may be enough to recover the data. 

The "reselect" procedure serves to dislodge any foreign particles and to 
recalibrate the positioner, should it be positioned to the wrong track. 

6,6 DISK DRIVSR 

As a comprehensive example of all the principles presented in this section, a 
sample disk driver is presented here. This driver provides the facilities to 
seek to a track, seek and read a sector, seek and write a sector, and seek 
and verify a sector. This verify operation is a special case of a sector 
read but only the header bytes are transferred into the buffer. This allows 
the use of a single disk buffer to perform write operations, which consist 
of a header check prior to write, writing the sector, and a read-after -write 
check. 

Hie power-on recalibration is transparent. The driver maintains a table 
containing the current track address of each drive connected to the controH<sr. 
The user's power on initialize software must set the entries in this table to 
0FFH. The fxrst time a drive is accessed, the driver will recognize this 

flag and recalibrate the positioner on the drive before performing the 
specified operation. 
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When the driver is called, the HL register must point to a parameter block 
(referred to as a disk control block) which specifies the operation to be 
performed. When the driver returns, the condition code will reflect the 
status of the operation. (See the listing for details.) 



The DGB is structured as follows; 



ADDRESS 



DCB + 



DCB + 1 



DCB + 2 
DCB + 3 
DCB + 4 
DCB + 5 



/ / 



/ / •■ .••■ / 



ID 

F 
L 
A 
6 



A 

F 

L 
A 
G 



FN 
CODE 



ONIT 
ADDR. 



SECTOR 



ADDRESS 



TRACK 



ADDRESS 



BUFFER ADDRESS 



BUFFER ADDRESS 



LSB 



MSB 



The DCB entries are described as follows: 

FN CODE Function code 

» Seek only 

1 « Seek and read sector 

2 =* Seek and write sector 

3 « Seek and verify sector 

ID FLAG Pre-Write Header (ID) Check Flag 

» Perforin check 

1 = Inhibit check 

SAW FLAG Read-After-Write Check Flag 

= Perform check 

1 = Inhibit check 

UNIT ADDR. Drive Unit Address 
0-3 

Sector and Track Address are the address of the sector which is to be 
written or read and the address of the track upon which tfte sector 
resides. The driver will seek as necessary to move the head to the 

desired track. 

The Buffer Address is a 16 bit memory address stored in standard 
8080 low/high format. 13113 imist be the address of a 268 byte read/ 
write buffer. The first two bytes of the buffer are reserved for the 
header . 
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To perforin a write operation, move the data to the read/write buffer, 
set up the DCB, and call the driver. 

To perform a read operation, set up the DCB and call the driver. When 
the operation is complete, the data from the desired sector will be in 
the read buffer. 



Rev. 4 7/77 6-23 



* DISK DRIVER FOR MICEOPOLIS * 

* FLEXIBLE DISK SUBSYSTEK * 

* COPYHIGKT KICHOPCLIS CCHPCHATIOSI * 

* 8 JUNE 1977 * 

41 m 

* 
m 

* I) CALLING SEaUENCEs 

* 

* LXI H^UDCS POir^ HL TO USER 

* CALL DSKIO DCE & PEHFOHK 

* JNZ EKROE OPEHATIOK 

* 

* UDCB IS THE USEr.'S DISK CO^^rHOL 

* BLOCK ¥KICK DEFINES THE OPSHATIOS 

* TO BE PERFORMED AND IS STFUCTTL«?ED 

* AS FOLLOWS: 
* 

* UDCE+0 FUNCTION CODS 

* SEEK TRACK OKLY 

* I SEEK AND READ SECTOR 

* 2 SEEK AND ¥RITE SECTOR 

* 3 SEEK AND VERIFY SECTOR 
m 

* WRITS OPEPJITIONS CONSIST OFs 

* U VERIFY THE TRACK/SECTOR ID 

* IN THE SECTOR IMMEDIATELY 

* PHECEEDIHG THE DESIRED SECTOR 

* 2) PSRFORK THE VRITE OPEEATIOK 

* 3 J THE SECTOR tffilTTSN IS THEK 

* VERIFIED BY A READ -AFTER -VRITE 

* CHECKSUM READ 

* NOTEsTHE ID CHECK AND READ AFTER 

* WRITE CHECKS CAW BE OUEPJ?IDDEM 

* BY CONTROL FLAGS IN UDCB+1 

* FOR %'RITING ON UNFCRKATTSD DISKS 

* UDCB+l CONTROL FLAGS/UNIT SELECT 

* BIT FUNCTION 

* 0-1 UNIT ADDRESS 

* 6 REAO-AFTER-«H ITE CHECK 

* CONTROLS 0=PERFOP.K# 

* 1»INKIBIT 

* 7 PRE -WRITE ID CHECK 

* CONTROL t 0-PSP.FORM, 

* I-INKIBIT. 

* UDCS+2 SECTOF. ADDRESS C0-15J 

* UDCB+3 TRACK ADDRESS C0-?63C34> 

* UDCB+445 BUFFER ADDRESS 

* BUFFER ADDRESS IS THE START 

* ADDRESS OF THE HEAD/WRITE 

* BUFFER TO BE USED IN 

* PERFORMING THE OPSHATICN. 
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* ALL OPEHATIONS 

* RECUIRE A 268 BYTE BUFFER 

* ORGANIZED AS FOLLOWS: 

* BYTE -- TRACK ID 

* BYTE 1 -- SECTOR ID 

* BYTE 2-267 — DATA 
* 

* BYTES AND I ARE FILLED 

* IN AS NECESSARY BY THE 

* DRIVER 
* 

* 2 3 THE DISK I/O DRIVER RETURNS VITH 

* THE CONDITION CODE SET TO Z IF 

* THE OPERATION WAS SUCCESSFUL AND 

* NZ IF AN ERROR OCCURRED. THE 

* A REGISTER WILL CONTAIN AN ERROR 

* CODE AS FOLLOWS! 

* 1 — PERMANENT I/O ERROR -AN 

* UNRECOVERABLE DISK ERROR 

* OCCURRED 

* 2 — PARAMETER ERROR - ONE OF THE 

* PARAMETERS IN THE DCB IS 

* INVALID 

* 3 — DRIVE NOT UP - THE SELECTED 

* DRIVE IS NOT READY 

* 4 — VRITE PROTECT - THE SELECTED 

* DRIVE IS WRITE PROTECTED AND 

* A VRITE OPERATION VAS 

* SPECIFIED 

* 3) INITIALIZATION REQUIREMENTS t 
* 

* n THE DRIVER CONTAINS A TABLE 

* LABLED "TRACK" VHICH CONTAINS 

* THE CURRENT TRACK POSITION FOR 

* EACH DRIVE CONNEXTED TO THE 

* CONTROLLER. EACH ENTRY MUST BE 

* INITIALIZED TO FFK TO CAUSE THE 

* TRACK POSITION OF EACH DRIVE TO 

* BE RE-CALIBRATED THE FIRST TIME 

* IT IS ACCESSED 
* 

* 2) THE PARAMETER LABELED "TRKMX" 

* MUST BE SET TO THE HIGHEST 

* TRACK ADDRESS VHICH IS 76 FOR 

* MOD II SUBSYSTEMS AND 34 FOR 

* MOD I SUBSYSTEMS 
m 

* 3) THE 16 BIT PAPJIMETER LABELED 

* "DADH"MUST BE SET TO THE ADDRESS 

* OF THE DISK CONTROLLER WHICH IS 

* THE BOOT PROM ADDRESS+20iH 



* 
* 
* 
000 ORG X'400' 

400 F3 DSKIO DI 
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0401 


C5 




0402 


D5 




0403 


ES 




0404 


210000 




0407 


39 




0408 


220807 




040B 


El 




040C 


E5 




040D 


UF506 




0410 


0606 




0412 


7E 


D: 


0413 


12 




0414 


23 




0415 


13 




0416 


05 




0417 


C21204 


* 
* 


041A 


21F506 




04 ID 


7E 




041E 


FE04 




0420 


D2D205 




0423 


23 




0424 


7E 




0425 


E63F 




0427 


FE04 




0429 


D2D205 




042C 


23 




0420 


7E 




042E 


FE10 




0430 


D2D20S 




0433 


23 




0434 


3AFE06 




0437 


96 




0438 


FAD205 


* 
* 


043B 
043E 


CDE405 
CDC504 


* 

m 

* 
* 
* 

* 

* 


0441 


3AF506 




0444 


87 




0445 


CACC04 


* 

* 

* 
* 



DS010 



PUSH 


B 


SAVE REGISTERS 


PUSH 


D 




PUSH 


H 




LXI 


Hj0 


SAVE STACK POINTER 


DAD 


SP 




SHLD 


STACK 




POP 


K 


GET POINTER TO 


PUSH 


H 


USER'S DCS 


LXI 


D#DCB 


COPY USER DCB TO 


MVI 


B,DCBLEN 


INTERNAL DCB 


MOV 


A,M 




STAX 


D 




I NX 


H 




INK 


D 




DCR 


B 




JNZ 


DS0 10 




VALIDATE DCS 


PARAMETERS 


LXI 


K#DCB 


FUNCTION MUST BE 


MOV 


A^M 


3 OR LESS 


CPI 


4 




JNC 


PARMER 


PARAMETER ERROR 


I NX 


H 




MOV 


A^M 


UNIT ADDRESS MUST 


AN I 


X'3F* 


BE LESS THAN 4 


CPI 


4 




JNC 


PARMER 




I NX 


H 




MOV 


A,M 


SECTOR MUST BE 


CPI 


16 


15 OR LESS 


JNC 


PARMER 




I NX 


H 




LDA 


TRKMX 


TRACK MUST BE LESS 


SUB 


M 


THAN OR ECUAL TO 


JM 


PARMER 


MAX TRACK 



ENSURE DRIVE IS OPERATIONAL 
CALL SLCT 

SEEK TO DESIRED TRACK 

CALL SEEK 

SET FUNCTION PARAMETER FROM DCS 
AND PERFORM ANY OTHER REQUIRED 
FUNCTION 



LDA 


DCSFN 


DONE 


IF FUNCT 


ORA 


A 


SEEK 


ONLY (0 3 


JZ 


DS100 


DONE 





PERFORM READ/WRITE FUNCTION 



RETRY CONTROL FOR READ/WRITE 
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0446 3E03 
044A 3206e7 
044D 3E04 
044F 320507 
0452 3E05 
0454 320407 



0457 2AF906 
04SA 220007 

045D 3AF506 

0460 3D 

0461 C26A04 



2664 CDS 106 
0467 C3A204 
046A 3D 
e46E C29704 



046E 3AF606 
0471 £660 
0473 C26304 
0476 3AF706 
0479 3D 
047A E60F 
047C 417 



* 

* 

* 

* 
« 

m 
* 
* 

* 

* 
* 

DS02G 

DS030 

DS040 

* 

* 

DS050 



* 



CS060 



OPERATIONS J 

A 3 LEVEL EETEY STF.UCTUF.E IS 
PFOVIDED AS FOLLOVSj 
1 -- IF AN ERPOF OCCUP.S^UF TO 5 
HETRYS OF THE OFFENDING OPEF-ATION 
WILL EE PSRFOKMED 

2-- IF THE LEVEL 1 P.ETRYS APE NOT 
Sl'CCESSFUL^TKE POSITIONER FILL 
BE STEPPED OFF TRACK AND BACK 
AND THE LEVEL 1 RETRY S '.'.'ILL BE 
PEHFOEMED. THE LEVEL 2 RETEYS 
WILL BE PEHFOP-KED UP TO 4 TIMES 
3 -.- IP THE LEVEL 2 RETRY 
PROCEDURE IS NOT SUCCESSFUL, THE 
UNIT WILL 5E DESELECTED TO UNLOAD 
THE HEAD THEN THE UNIT WILL EE 
RES ELECTED, THE POSITIONER '-'ILL 
EE RECALIBRATED AND MOVED BACK 
TO THE DESIRED TRACK AND THE 
LEVEL 1 AND 2 RETRY PROCEDURES 
VILL EE PERFORMED. THIS VILL BE 
DONE UP TO 3 TIMES. IF NOT 
SUCCESSFUL, A PERMANENT I/O 
ERROR FILL RESULT 



MVI 
STA 

HV I 
STA 
MVI 

STA 



A, 3 

L3RTRY 
A, 4 

L2HTRY 
A, 5 

LIRTRY 



PRESET RETRY 
COUNTERS 



SELECT DESIRED 
PERFORM 



LKLD 

SHLD 

LDA 

DCE 

JNZ. 



DCBAD 

EUFADR 

DCBFN 

A 

DS060 



FUNCTION AND 



PRESET BUFFER 
ADDRESS . 
GET FUNCTION 



READ SECTOR 



JMP 
DCR 



READAL 
DS090 
A 
DS080 



READ SECTOR 
CHECK FOR ERROR 



VRITE SECTOR 



LDA 
AN I 
JNZ 
LDA 
DCR 
AN I 

mv 



DCBUN 

KCI 

DS070 

DCBSC 

A 

X'0F* 



IF HEADER CHECK 
INHIBIT SET GC 
WRITE 

BACKSPACE SECTOR 
COUNT MOD 16 
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0470 


COB106 




CALL READCK 


DO PRE -WRITE HDR 


0480 


C2A204 




JN2 DS090 


CHECK - ABORT ERR 


0483 


CD2F06 


DS070 


CALL WSECT 


GO v;rite 


0486 


3AF706 




LDA DCBSC 


DO RAW CHECKSUM 


0489 


47 




MOV B#A 


READ CHECK 


048A 


3AF606 




LDA DCBUN 


UNLESS INHIBITED 


048D 


E640 




AN I RAF I 




048F 


EE40 




XRI EAFI 




049 i 


C4Bi06 




CNZ REAOCK 




0494 


C3A204 




dMP DS090 


GO CHECK FOR ERR 


0497 


3D 


DS080 


OCR A 




0498 


C2D205 


* 
* 


JNZ PARMER 


TRAP -JUST IN CASE 






VERIFY SECTOR 




049B 


3AF7a6 


LOA DCBSC 




049E 


47 




MOV E#A 




049F 


CDB106 




CALL READCK 


DO CHECKSUM READ 






* 
DS090 


CHECK FOR ERROR 


04A2 


CACC04 


JZ OS 1 00 


NO ERROR-EXIT 


04A5 


3A0407 




LDA LIRTRY 


LEVEL 1 — RETRY 


04A8 


3D 




OCR A 


UP TO 5 TIMES 


04A9 


320407 




STA LIRTRY 




04AC 


C2S704 


* 


JNZ DS050 








RETRIED 5 TIMES - STEP OFF TRACK 






4c 


AND BACK AND REPEAT 


04AF 


CO360S 




CALL RESTEP 




04B2 


3A0507 




LDA L2RTRY 


PERFORM UP TO 4 


04B5 


3D 




OCR A 


TIMES 


04B6 


320507 




STA L2RTRY 




04B9 


C25204 


* 


JNZ DS040 








STEPPED OFF 4 


TIMES - DESELECT 






* 


DRIVE TO UNLOAD HEAD THEN 






* 
* 


SELECT* RESTORE AND RE-SEEK 


04ac 


CD6305 


CALL RESLCT 




04BF 


3A060 7 




LDA L3RTRY 


PERFORM UP TO 3 


04C2 


3D 




DCR A 


TIMES 


04C3 


320607 




STA L3RTRY 




04C6 


C24O04 


* 
* 


JNZ DS030 








UNSUCCESSFUL ■ 


-- ABORT WITH 






* 

* 

* 

OS 100 


PERMANENT I/O 


ERROR 


04C9 


C3CC0S 


JMP PERMER 








END OF OPERATION 


04CC 


2A0807 


LHLD STACK 


RESTORE STACK PTR 


04Cr 


F9 




SPHL 




0400 


El 




POP H 


RESTORE REGISTERS 


0401 


01 




POP D 
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04D2 


CI 




POP 


B 




04D3 


00 


EI ADR 


NOP 




SPACE FOR EI 


0404 


C9 


* 


RET 










* 


SEEK 


TO DESIRED TRACK 


04D5 


CDE405 


ft 

SEEK 


CALL 


SLCT 


ENSURE DPIVE SLTD 


04D8 


E5 




PUSH 


H 


AND READY 


04D9 


CBBDeS 




CALL 


LDTRK 


POINT HL TO TRACK 


04DC 


3EFF 




MVI 


AjX'FF' 


SEE IF DRIVE HAS 


04DE 


BE 




CMP 


M 


BEEN INITIALIZED 


04DF 


C2S504 




JNZ 


SEEK I 


YES-CONTINUE 


04E2 


CD7905 




CALL 


REST OR 


CALIBRATE POSITION 


04E5 


3AF806 


SEEK I 


LDA 


DCBTK 


GET TRACK FROM DCB 


04E8 


4F 




MOV 


C^A 


SAVE IN C 


04E9 


96 




SUB 


M 


ALREADY AT TPJ\CK7 


04EA 


CA04 5 


* 
* 


JZ 


SEEKR 


YES -RETURN 






NOT AT THACK - 


-'issue the 






* 


APPP.OFP.IATE MUMBEK OF STEPS TO 






* 

* 


MOVE 


TO THE DESIRED TRACK 


04ED 


FAFA04 


JM 


SEKOUT 




04F0 


CD0705 


SEKIN 


CALL 


STEPIN 




04F3 


3D 




DCR 


A 




04F4 


C2F004 




JNZ 


SEKIN 




04F7 


C30105 




..JMP 


SEEKRl 




04rA 


CD1D05 


SEKOUT 


CALL 


STPOUT 




04FD 


3C 




INR 


A 




04FE 


C2FA04 




UNZ 


SEKOUT 




0501 


CD2D05 


SEEKRl 


CALL 


SETTLE 


WAIT HEAD SETTLE 


0504 


71 


SEEKR 


MOV 


MjC 


STORE TRACK 


0505 


El 




POP 


H 




0506 


C9 


* 

* 
STEPIN 


RET 










STEP 


POSITIONER IN I TRACK 


0507 


F5 


PUSH 


PSV 




0508 


D5 




PUSH 


D 




0509 


E5 




PUSK 


H 




50A 


AF 




XRA 


A 


SET DIRECTION FLAG 


050E 


320707 




STA 


DIRCTN 




050E 


2A0207 




LHLD 


DADR 


STEP IN ONE TRK 


0511 


3661 




MVI 


M^STEP+l 




0513 


1 1 1E00 


STPl 


LXl 


D#30 


VAIT STEP TIME 


0516 


CD1706 




CALL 


TIMER 




0519 


El 




POP 


H 




051A 


Dl 




POP 


D 




051B 


Fl 




POP 


PS¥ 




051C 


C9 




RET 










* 

* 


STEP 


POSITIONER OUT I TRACK 


051D 


F5 


STPOUT 


PUSH 


PSV 




0S1E 


D5 




PUSH 


D 
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iSlF 
0520 
0522 
0525 
0528 
05 2A 



E5 

3EFF 

320707 

2A0207 

3660 

C31305 



PUSH 


H- 


MVI 


A^X«FF» 


STA 


DIRCTN 


LHLD 


DADR 


MVI 


MjSTEP 


JMP 


STPl 



SET CISECTION FLAG 



STEP OUT ONE TRK 
GO WAIT STEP TIME 



052D DS 
052E U0A00 
0531 CD1706 

0534 01 

0535 C9 



* 

SETTLE PUSH 
LXI 



WAIT HEAD SETTLE TIME 



D 

D^10 
CALL TIMER 
POP D 
RET 



10 MILLISECONDS 



0536 
0539 
05 3A 
053B 
053E 
0541 
0542 
0545 
0546 
0549 
054C 
054F 
0552 
0555 
0556 
0559 
iSSC 
055F 
0562 



CDBD0S 

7E 

87 

C24205 

CD7905 

C9 

3A0707 

87 

C25605 

CD070S 

CD2D0S 

CD100S 

CD2O0S 

C9 

CD1D05 

CD2D0S 

CD0705 

CD2D05 

C9 



STEP OFF TRACK ONE AND BACK TO CORRECT 
POSSIBLE MARGINAL TRACK POSITION 
OF DRIVE WHICH WROTE THE DISK 

IF TRACK SUBSTITUTE RESTOR 



GET CRNT TRK ADDR 
GET CRNT TRK 



* 
* 

* 

m 

RESTEP CALL LDTRK 
MOV A^M 
ORA A 
JNZ RSTPA 
CALL RESTOR 
RET 

RSTPA LDA DIRCTN 
ORA A 
JNZ RSTPB 
CALL STEP IN 
CALL SETTLE 
CALL STPOUT 
CALL SETTLE 
RET 

RSTPB CALL STPOUT 
CALL SETTLE 
CALL STEP IN 
CALL SETTLE 
RET ■ 



USE RESTOR IF TK 



* RETRY ROUTINE TO RESTORE TO THEN 
» LIFT HEAD* LOVER HEAD AND RESEEK 



0563 E5 RESLCT PUSH H 

0564 2A020 7 LHLD DADR 
0567 36A0 MVI M^RESET 
0569 11CS00 LXI D*S00 
056C CD1706 CALL TIMER 
056F CDE40S CALL SLOT 

0572 El POP H 

0573 CD7905 CALL RESTOR 
0576 C3D504 JMP SEEK 



* 



RESET CONTROLLER 



RESELECT,LOVR HEAD 



GO RE -SEEK 



RESTORE POSITIONER TO TRACK 
POSITIONER MUST BE STEPPED OUT 
UNTIL THE TRACK SWITCH IS MADE 
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79 


E5 


RESTOR 


TO CALIBRATE 1 

PUSH H 


"RACK POSITION 


.7A 


C5 




PUSH B 




.7B 


CDBD0S 




CALL LDTRK 


POINT HL TO TRACK 


i7E 


36FF 




MVI M^X'FF' 


PRESET TO BAD TRK 


JS0 


CD8S05 




CALL RESTRl 


RESTORE TO TK 


583 


3600 




MVI Mv0 


SET TRACK=0 


5&5 


CI 




POP B 




i86 


El 




POP H 




587 


C9. 


* 


RET 








RESTORE TO TK 





588 


E5 


RESTRl 


PUSH H 




589 


CDE405 




CALL SLCT 


ENSURE UNIT SLCTD 


58C 


D5 




PUSH D 


AND READY 


58D 


C5 




PUSH B 




58E 


2A0207 




LHLD DADR 


POINT TO STATUS 


•591 


23 




INX H 


BYTE 


'592 


7E 




MOV A^M 


ALREADY AT 


1593 


E608 




AMI TK0 


TRACK ? 


1595 


CAA405 




JZ RESTS 


NO - PRESS ON 



5598 3E08 
359A CD0705 
359D 3D 
359E C29A05 
35A1 CD2D05 



05A4 0E55 
0SA6 7E 
0SA7 E608 
05A9 C2B605 
05AC CD1D0S 
05AF 0D 
05B0 C2A605 



05B3 C3CC05 



STEP OUT UNTIL TRACK SWITCH 
IS ACTUATED OR UNTIL 85 STEPS 
HAVE BEEN ISSUED SO THAT WE 
DONT BANG AGAINST THE STOP 
FOREVER IF TK0 SWITCH IS 
BROKEN 



* ALREADY AT TRACK - STEP 

* IN S TIMES THEN RESTORE 

* TO ENSURE GOOD POSITION 

* 

MVI A^8 
REST2 CALL STEPIN 

DCR A 
JNZ REST2 
CALL SETTLE 

* 

REST3 MVI C^85 
REST3A MOV A^M 

ANI TK0 

JNZ REST4 

CALL STPOUT 

DCR C 

JNZ REST3A 
♦ 

* MAXIMUM NUMBER OF STEPS HAVE 

* BEEN ISSUED - ERROR ABORT 

JMP PERMER 

♦FOUND TRACK - WAIT 

* SETTLE TIME THEN EXIT 
* 



STEP IN 8 
TRACKS 

WAIT SETTLE TIME 



LOAD MAX STEPCNT 
TRACK 0? 

YES- PRESS ON 
STEP OUT ONE TK 
MAX STEPS ? 
NO - TRY AGAIN 
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0SB6 


CDaDflS 


REST4 


CALL 


SETTLE 


VAIT HEAD SET' 


i5B9 


CI 






POP 


B 




0SBA 


Dl 






POP 


D 




0SBB 


El 






POP 


H 




0SBC 


C9 






RET 










3|l 


LOAD 


ADDRESS OF CURRENT TRACK ON 






* 
* 

LI 


CURRENT UNIT INTO 


ML 


05BD 


D5 


3TRK 


PUSH 


D 




05BE 


3AF606 






LDA 


DCBUN 




05C1 


E603 






AN I 


03 


MASK OUT UNIT 


05C3 


5F 






MOV 


E^A 




05C4 


1600 






MVI 


D^0 




05C6 


21FC06 






LXI 


K^ TRACK 


POINT HL INTO 


0SC9 


19 






DAD 


D 


TRACK TABLE 


05CA 


Dl 






POP 


D 




05CB 


C9 


* 
* 




RET 










* 
* 
* 

3k 


EHROP. EXITS 




05CC 


3S01 


PEHKEF. 


MVI 


A^l 




05CE 


B7 






ORA 


A 




05CF 


C3CC04 






JKP 


DS100 




05D2 


3E02 


PARMER 


MVI 


A^2 




05D4 


a? 






ORA 


A 




05D5 


C3CC04 






JMP 


DSI00 




05D8 


3E03 


DRIVER 


MVI 


A, 3 




05DA 


B7 






ORA 


A 




05DB 


C3CC04 






JMP 


DS100 




05DE 


3E04 


PROTER 


MVI 


A^4 




05E0 


B7 






ORA 


A 




05E1 


C3CC04 


* 

* 
* 




JMP 


DS100 





* REGISTER DEFINITIONS AND * 

* FLAG EQUATES FOR MICROPOLIS * 

* FLEXIBLE DISK CONTROLLER B * 

* 





* 






* 




F400 


BPROM 


EfiU X»F400» 


F600 


DIADR 

* 
* 


EQU BPROM+X'0200' 




DATA REGISTERS 


F602 


¥DATA 


ESU DIADR+X'02' 


F602 


RDATA 


EQU VDATA 




* 


STATUS REGISTERS 




* 
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F600 



0040 
0080 
0020 



F60i 



0080 
0040 
0020 
0010 
0008 
0004 



F600 



0020 
0040 

0060 

0080 
00A0 



DSECTR 

* 0- 

♦ 
m 
* 

* 

SIFLG 
SFLG 

DTMP. 

* 

DSTAT 

* 0- 

♦ 

* 

TFLG 

INTE 

P.DY 

VPT 

TK0 

USLT 

* 

DCMND 
♦CALSO 

* 0' 

* 

SLUN 

* 

SINT 

* 
STEP 

WTCKD 

* 

HESET 
* 
* 



EQU DIADR 

3 SECTOR COUNT 

4 SPARE 

5 SPARE 

6 ECTR INTERRUPT FLAG 

7 SECTOR FLAG 

FLAG BITS 

EQU X'40* 

EQU X»80« 

EQU X'20' 



ECU DIADR+l 

1 UNIT ADDRESS 

2 UNIT SELECTED 

3 TRACK 

4 WRITE PROTECT 

5 DISK READY 

6 PINTE 

7 TRANSFER FLAG 



CLOV TRUE) 



FLAG SITS 



EQU 
EQU 
EQU 
EQU 
EQU 
EQU 



X'80» 
X»40» 
X«20» 
X'I0» 
X'08' 
X'04' 
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COMMAND REGISTER 

EQU DIADR 

WILL RESPOND TO DISK+U 

■I COMMAND MODIFIER 
•7 COMMAND 

COMMANDS 

EQU X'20» SELECT UNIT 
MODIFIER CONTAINS UNIT ADDRESS 
EQU X»40» SET INTERRUPT 
MODIFIER »l ENABLE INTERRUPT 

-0 DISABLE INTERRUPT 
EQU X'60' STEP CARRIAGE 
MODIFIER -00 STEP OUT 

-01 STEP IN 
EQU X'S0« ENABLE WRITE 
NO MODIFIER USED 

EQU X'A0' RESET CONTROLLER 
NO MODIFIER USED 
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0086 




* 
SCLEN 


ESU 


134 


SECTOR LNGTH/2 








1^ 


SELECT DRIVE 


SPECIFIED 








* 
SLCT 


BY UNIT ADDRESS IN DCS 




05E4 


D5 


PUSH 


D 






0SE5 


C5 




PUSH 


B 






05E6 


E5 




PUSH 


H 






asE? 


2A0207 




LHLD 


DADR 


GET CONTROLI.fr ADR 




05EA 


3AF606 




LDA 


DC8UN 


GET UNIT ADR FROM 




05ED 


E603 




AN I 


X»03' 


DCB 




05EF 


47 




MOV 


B^A 


AND SAVE 




05F0 


23 




I NX 


H 


POINT TO STATUS 




05FI 


7E 




MOV 


A#M 


AND READ 




05F2 


4F 




MOV 


C,A 


SAVE STATUS 




0SF3 


E607 




AN I 


X'07» 


MASK USLD 4 ADDR 




05FS 


AS 




XRA 


B 


DESIRED UNIT PREV 








* 


NOTE' 


-THIS TEST VILL FAIL IF 








* 


CONTROLLER IS 


NOT PLUGGED IN 




05F6 


79 




MOV 


A#C 


SELECTED? 




asF? 


CAaC06 




az 


SL010 


YES-CHECK RDY 




05FA 


78 




MOV 


A#B 


GET UNIT ADDRESS 




aSFB 


F620 




OR! 


SLUN 


BUILD COMMAND 




05FD 


77 


* 


MOV 


M#A 


OUTPUT COMMAND 
WAIT 250 MSEC FOR • 




05FE 


11FA00 




LXI 


0^250 


SECTOR CNTR TO 




0601 


CD1706 




CALL 


TIMER 


GET IN SYNC 




0604 


7E 




MOV 


A^M 


GET STATUS 




0605 


E607 




AN I 


X'07' 


SELECTED NOW? 




0607 


AS 




XRA 


B 






0608 


7E 




MOV 


A#M 


GET STATUS AGAIN 




0609 


C21006 




JN2 


SL020 


ERROR IF NOT SLTD 




060C 


E620 


SL010 


AN I 


RDY 


ENSURE UNIT IS 




060E 


EE20 




XRI 


RDY 


READY 




0610 


El 


SL020 


POP 


H 






061 1 


CI 




POP 


B 






0612 


Dl 




POP 


D 






0613 


C8 




RZ 




RETURN IF OK 








♦ 


DRIVE NOT UP 


ERROR 




0614 


C3D80S 


» 


JMP 


DRIVER 










* 
* 


I MILLISECOND 


TIMER 








* 

* 
TIMER 


DE» (DELAY) TIME IN MSEC 








A IS 


DESTROYED 




0617 


CS 


PUSH 


B 






0618 


E5 




PUSH 


H 






0619 


2A0207 




LHLD 


DADR 






061C 


7E 




MOV 


A*n 


RE -TRIGGER 4 




061D 


0660 




MVI 


B*96 


SECOND TIMER 




061F 


78 


TI0t0 


MOV 


A#B 


COUNT 




0620 


0601 




SUI 


I 


DELAY LOOP- I. 008 




0622 


B7 




ORA 


A 


MSEC #500 NSEC 
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0623 C22006 




JNZ 


T1010+1 






* 


IMSEC 


; EXPIRED 


- DECREMENT DELAY 




* 
* 


MULTIPLIER i CHECK FOR DONE 


0626 IB 


DCX 


D 




0627 7B 




MOV 


A^E 




0628 B2 




ORA 


D 




0629 C2iF06 




JNZ 


T1010 




062C El 




POP 


H 




062D CI 




POP 


B 




062E C9 




RET 








« 


WRITE 1 SECTOR 




062F CDE405 


* 

WSECT 


CALL 


SLCT 


ENSURE UNIT SLD 


0632 3AF706 




LDA 


DCBSC 


AND READY 


0635 47 




MOV 


B^A 




0636 C5 




PUSH 


B 




0637 0E86 




MVI 


C^SCLEN 


C <- BYTCT/2 


0639 2A0207 




LHLD 


DADR 


GET CONTROLLER ADR 


063C E5 




PUSH 


H 




063D 23 




I NX 


H 


READ STATUS 


063E 7E 




MOV 


AsH 


ABORT IF 


063F E6I0 




ANI 


VPT 


WRITE PROTECTED 


0641 C2DE05 




JNZ 


PROTER 




0644 2A0007 




LHLD 


BUFADR 


GET BUFFER ADDR 


0647 E5 




PUSH 


H 




0648 Dl 




POP 


D 


MOVE TO DE 


0649 3AF806 




LDA 


DCBTK 


MOVE TRACK AND 


064C 77 




MOV 


M^A 


SECTOR ID TO WRITE 


064D 23 




INK 


H 


BUFFER 


064E 70 




MOV 


M>B 




064F 2A0207 




LHLD 


DADR 


GET CONTROLLER ADR 


0652 CDE906 


* 


CALL 


GET SEC 


WAIT FOR SECTOR 




FOUND DESIRED 


SECTOR- 






ENABLE WRITE 




0655 3680 


W 


MVI 


M^WTCMD 




0657 23 


* 


I NX 


H 






WAIT 


FOR TRANSFER FLAG 


0658 B6 


•* 

VS010 


ORA 


M 




0659 F25806 


^ 


JP 


WS010 






* 
* 


INSERT SYNC BYTE 


065C 23 


INX 


H 




065D 36FF 


* 


MVI 


M#X'FF» 




065F AF 


XRA 


A 


CLEAR CARRY 


0660 EB. 




XCHG 






0661 0600 


* 


MVI 


B#0 


AND CHECKSUM 
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0663 


7E 


* 
WS020 


MOV A,M 


GET BYTE FROM MEM 


0664 


12 




STAX D 


WRITE TO DISK 


0665 


88 




ADC B 


ADD TO CKSUM 


0666 


47 




MOV B,A 


SAVE CKSUM 


0667 


23 




INK H 


NEXT BYTE 


0668 


7S 




MOV A,M 


-ETC- 


0669 


12 




STAX D 




066A 


88 




ADC B 




066B 


47 




MOV B,A 




066C 


23 




INK H 




0660 


0D 




OCR C 




066E 


C26306 


^ 


JN2 WS0 20 








* 


END OF DATA - 


INSEHT CHECKSUM 


0671 


78 




MOV A#B 




0672 


12 


^ 


STAX D 










VAIT END OF SECTOR 


0673 


SI 


POP H 




0674 


AF 




XRA A 




067S 


B6 


VS030 


ORA M 


WAIT SCTR FLAG 


0676 


F27506 




JP VS030 




0679 


110100 




LXl D,l 


VAIT I MSEC FOR 


067C 


CD1706 




CALL TIMER 


ERASE DELAY 


067F 


CI 




POP E 




0680 


C9 




RET 

READ 1 SECTOR 








* 


VERIFY CHECKSUM AND HEADER 






9 

* 


RETURNS 2= OK 








* 
READAL 


NZ=ERROR 


0681 


CDE405 


CALL SLOT 


ENSURE UNIT IS 






« 




RDY + SLTD 


0684 


3AF706 




LDA DCBSC 


GET SECTOR ADDR 


0687 


47 




MOV E,A 


FROM DC3 


0686 


C5 




PUSH B 




0689 


0ES6 




MVI C^SCLEN 


C <- BYTCT/2 


068S 


CDO606 


* 

Ik 


CAI.l. VTSYNC 


WAIT DESIRED 
SECTOR & STRIP 
SYNC BYTE 






* 
* 


FOUND DESIRED 


SECTOR - READ 


06SE 


EB 


XCHG 




068F 


0600 


* 

RDA10 


MVI B^a 


CLR CHECKSUM 






READ LOOP 




069i 


lA 


LDAX D 


READ FROM DISK 


0692 


77 




MOV M^A 


MOVE TO BUFFER 
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0693 23 

0694 88 

0695 47 

0696 lA 

0697 77 

0698 23 

0699 88 
069A 47 
069B 0D 
0690 C29106 



069F lA 
6A0 B8 
06A1 C! 
06A2 C0 



06A3 2A0007 
6A6 EB 
06A7 CDBD05 
06AA lA 
06AB BE 
06AC C0 
06AD 13 
06AE !A 
06AF B8 
06B0 C9 



I NX 


K 


NEXT LOG 


ADC 


B 


ADD TO CHECKSUM 


MOV 


B^A 


AND SAVE 


LDAX 


D 


NEXT READ 


MOV 


M^A 


-ETC- 


INX 


H 




ADC 


B 




MOV 


E^A 




DC P. 


C 


END OF DATA? 


JNZ 


RDA10 


NO-LOOP 



* 
* 
* 



EMD OF DATA-READ CHECKSUM 



LDAX D 
RDA020 CMP B 



POP 
RNZ 



B 



COMPARE VITH 
COMPUTED CHECKSUM 

RETURN IF ERROR 






CHECKSUM OK-VERIFY HEADER 



LHLD 


BUFADR 


XCHG 




CALL 


LDTRK 


LDAX 


D 


CMP 


M 


RNZ 




INX 


D 


LDAX 


D 


CMP 


B 


RET 





06B1 CS 
06B2 COE405 
06B5 0E85 
06B7 CDD606 

06BA 0600 
06BC 7E 
06BD 12 

06BE 88 
aSBF 47 



POINT DE TO READ 

BUFFER 

POINT TO CURRENT 

TRACK AND COMPARE 

WITH TRACK ID READ 



COMPARE SECTOR ID 
VITH DESIRED SCTR 



VERIFY SECTOR 

READ THROUGH SECTOR WITHOUT 
MOVING DATA INTO MEMORY AND 
VERIFY TRACK AND SECTOR ID 
AND CHECKSUM 

ONLY TRACK AND SECTOR ID ARE READ 
INTO MEMORY AND CHECKSUM IS 
VERIFIED 

SECTOR IS SPECIFIED BY E REG 

RETURNS Z-OK 

NZ "ERROR 



SAVE SECTOR 
ENSURE SLTD«RDY 
C «- BYTCT/2-1 
WAIT SECTOR i STRP 
OFF SYNC BYTE 
CLR CHECKSUM 
READ TRACK ID 
SAVE IN BUFFR 
ADD TO CHECKSUM 
AND SAVE 



* 
* 

* 
* 

* 

* 

READCK PUSH B 

CALL SLOT 

MVI C^SCLEN-l 

CALL VTSYNC 



MVI 


B#0 


MOV 


A^M 


STAX 


D 


ADC 


B 


MOV 


B^A 
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06C0 


13 




I NX 


D 




06C1 


7E 




HOV 


A#M 


READ SCTR ID 


06C2 


12 




STAX 


D 


AND SAVE 


06C3 


88 




AOC 


B 




06C4 


47 




MOV 


B#A 




06C5 


00 


^ 


MOP 










* 


READ 


THROUGH 


REMAINDER OF SECTOR 






* 
* 
RDCKI0 


TO COMPUTE i 


VERIFY CHECKSUM 


06C6 


7E 


MOV 


A#M 


READ FROM DISK 


06C7 


88 




ADC 


B 


ADD TO CHECKSUM 


06C8 


47 




MOV 


B^A 


SAVE CKSUM 


06C9 


00 




MOP 






06CA 


00 




NOP 






06CB 


7E 




MOV 


AjM 


-ETC- 


06CC 


88 




AOC 


B 




06CD 


47 




MOV 


B^A 




06CE 


00 




OCR 


C 




06CF 


C2C606 


3t 


JNZ 


RDCK10 








END 1 


OF DATA 


- READ CHECKSUM 


0602 


7E 


^ 


MOV 


AjM 




06D3 


C3A006 




JMP 


RDA020 


GO CHECK HDR i, 
CHECKSUM 






* 

4> 


¥A1T 


FOR DESIRED SECTOR • 






* 


TO COME AROUND AND STRIP OFF 






* 

m 
WTSYNC 


SYNC 


BYTE FOR READ ROUTINES 


06D6 


2A0007 


LHLD 


BUFADR 


GET BUFFER ADDRES: 


06 D9 


EB 




XCHG 






06DA 


2A0207 




LHLD 


DADR 


AND CONTROLLER AO: 


06DD 


CDE906 




CALL 


GETSEC 


WAIT FOR SECTOR 


06E0 


23 




INX 


H 




06E1 


B6 


VTS010 


ORA 


M 


WAIT FOR XFER RDY 


06E2 


F2E106 




JP 


VTS010 


FLAG 


06ES 


23 




INX 


H 


OK-READ IN SYNC 


06E6 


7E 




MOV 


Aj^M 


BYTE THROW IT 


06Et 


AF 




XRA 


A 


A¥AY, CLEAR CARRY 


06E8 


C9 


^ 


RET 




AND GO READ 






1* 


WAIT 


FOR DESIRED SECTOR TO COKE 






* 
GETSEC 


AROUND 




06E9 


7E 


MOV 


A#M 


VAIT FOR SCTR FLA 


06EA 


B7 




ORA 


A 




06EB 


F2E906 




JP 


GETSEC 




06EE 


E60F 




AN I 


X'fF* 


OK -IS THIS THE 


06r0 


AS 




XRA 


B 


ONE ¥E ¥ANT7 


06F1 


C2E906 




JN2 


GETSEC 


NO-WAIT 


06F4 


C9 


* 


RET 




PRESS ON 






RAM 


STORAGE 


REQUIRED FOR DRIVER 
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>• 










* 


INTERNAL DISK CONTROL BLOCK 


06F5 




DCB 


EQU 


* 


06F5 




DCBFN 


DS 


I 


06F6 




OCBUN 


DS 


I 


06F7 




DCSSC 


DS 


1 


06F8 




DCBTK 


DS 


1 


06F9 




DCBAD 


DS 


2 


0006 




DCBLEN 

* 


ECU 


*-DCB 


0080 




m 
HCI 


ECU 


X»S0« HEADER CHECK INH 


0040 




RAFl 


ESU 


X»40' RAV CHECK INHIBIT 


06FB 


4C 


TRKMX 


DC 


76 MOD 2 






* 
* 


CURRENT TRACK TABl.F 






* 


MUST 


BE INITIALIZED TO FF 






m 


AT POWER ON TO CAUSE DISK TO 






m 


BE RESTORED TO TRACK 






* 


THE 


FIRST TIME IT IS ACCESSED TO 






* 
* 
TRACK 


CALIBRATE TRACK POSITION 


06FC 


FF 


DC 


X»FF» 


06FD 


FF 




DC 


X'FT' 


06FE 


FF 




DC 


X'FF* 


06FF 


FF 


m 


PC 


X»FF« 


0700 




7^ 

8UFADR 


DS 


2 CURRENT BUFFER AD 


0702 


00F6 


9 

DADR 


DC 


BCDIADR) DISK CTLR ADDR 






* 


RETRY COUNTERS 


0704 




LIRTRY 


DS 


I 


0705 




L2RTRY 


DS 


I 


0706 




L3RTRY 


DS 


I 


070 7 




9 

DIRCTN 


DS 


1 


0708 




STACK 

* 
<<> 


DS 


2 SAVED SP 



070A 



END 



*-* 
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APPENDIX A ^ BASIC ERROR MESSAGES 

ARGUMENT - Argument in a function reference is the wrong data type or missing, 

ARRAY INDEXING ERROR - A, reference to an array element contains an invalid 
index. May also be caused if an attanpt is made to reference an array ele- 
ment before the array is defined in a DIM statanent. 

CONVERSION ERROR - Attempt to assign a real value to an integer variable and 
the converted value is too large. 

DIGIT BEYOND RADIX - A number specified in radix format includes a digit which 
is invalid for the specified radix, 

DISK FULL - An attempt was made to allocate another track for a file and no 
free tracks remain. 

DRIVE NOT UP - The desired disk unit. does not have a diskette loaded, is not 
up to speed, or has a malfunction which prevents it from accepting cormiands. 

DUPLICATE NAME - An attempt, was made to OP£N a file name which already exists 
as a new file. 

END-FILE - The end-of-file was encountered in a disk file read-. 

EXTRA INPUT IGNORED - The response to an INPUT statanent contained more values 
than were needed to satisfy the variable list and the extra values were 
ignored. - 

FILE ALREADY OPEN - File number specified in an OPEN statement already has a 
file opened to it. 

FILE NOT FOUND - File name specified in a disk I/O command does not exist on 
the specified diskette. 

FILE NOT OPEN - File number specified in a disk I/O statement does not have 
a file name opened to it. 

FILE TYPE ERROR - The attributes of the referenced file are inconsistent with 
the requiranents of the statanent or coimand that referenced it. 

ILLEGAL IMMEDIATE - An at1;anpt was made to use a statement as a direct command, 
but the statement. is only valid within a BASIC program. 

INPUT OVERFLOW - A program line greater than 250 characters in length was en- 
tered - the entire program -line is cancelled. 

INSUFFICIENT INPUT - The response to an INPUT statement contained insufficient 
values to satisfy the variable list. 

INTERRUPT - Execution of a program was interrupted by entry of a CNTL/C key at 
the terminal. 

INVALID DISK FILE NAME - Disk file name specified is not a valid disk file 
name. 
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LOAD OVERRUN - The length of the BASIC program being loaded exceeds the 
memory space currently available to BASIC. 

LOS OF NEG # - Attempt was made to pass a negative or zero value to the 
LOG or LN function. 

MEMORY OVERFLOW - Insufficient memory exists for execution of the program, 

MISSING FOR - A NEXT statement was encountered prior to execution of a 
FOR statement specifying the loop variable. 

NOT A FILE # - File number specified in a disk I/O statement is not one of 
the digits 0-9. 

NOT A LOAD FILE - Attempt to load a data format disk file. 

NOT A RECORD # - The value following the RECORD option in a GET or PUT 
statement is not a valid record number. 

NOTHING TO RETURN TO - A RETURN statement was encountered prior to executing 
a GOSUB statement. 

NUMBER OUT OF RANGE - The value of an expression referenced 1s illegal. 
Refer to the description of the statement in error for the range of 
valid values. 

OVERROW - Numeric overflow - Result of an operation is too large to be 
contained in a variable. 

OUTPUT OVERFLOW - A PRINT or PUT statement has attempted to create an output 
line (record) greater than 250 characters in length. This exceeds the 
maximum internal buffer capacity. The line (record) 1s not output. 

PARM ERR - Disk I/O Parameter error - usually caused by setting the sequential 
GET/PUT pointers to an Invalid value. 

PERM FILE - An attempt was made to SCRATCH a permanent file. * 

PERM I/O ERROR - A disk I/O error occurred which was not recoverable in the 
disk I/O retry logic. 

PRECISION ERROR - A numeric function or the f operator was referenced with 
RSIZE greater than 10. 

READY - The BASIC interpreter is ready for entry of consnands or program 
lines at the terminal . 

RAN OUT OF DATA - A READ statement depleted the data list before satisfying 
the variable list. A GET statement encountered the end of the current 
record without satisfying the variable list. 
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SIZES ERROR - One of the parameters of a SIZES statement is Invalid or 

there are already variables allocated when the statement is encountered. 

SQRT OF NEG # - Attempt to pass a negative number to the SQR function. 

STACK OVERFLOW - The statement in error contains an expression which is 

too complex. Break the expression into multiple expressions which are 
less complex. 

ST^f^ # NOT FOUND - The statement in error tried to transfer control to a 
program line number which does not exist. 

SYNTAX - The statement in error is not recognizable or contains an invalid 
structure such as unequal right and left parentheses. 

TYPE ERROR - Attempt to assign a value of the wrong data type to a variable. 

WRITE PROTECT - An attempt was made to write on a file with a write protect 
attribute or the diskette on which the file resides has a write protect 
tab installed. 

UNDERFLOW - Numeric underflow - The result of an operation is too small to 
be assigned to a variable, 

X+Y INDETERMINATE - Attempt to take a fractional power of a negative number 

or or to raise to a negative or power, which are undefined operations. 

ZERO DIVIDE - Attempt to divide by zero which is an undefined operation. 
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APPENDIX B - BASIC UTILITY 



B.0 DESCRIPTION 



The MDOS System diskette included with each system contains a BASIC 
utility program. 

The functions provided are: 

1) Initializing a diskette; This must be done before a newly 
purchased diskette can be used by MDOS or M.BASIC to store 
data or programs. The INIT command in MDOS may be used 

instead. It has the same effect. 

2) Examining and modifying memory; Used to examine, and change 
if desired, the contents of any location in memory. The P 
command in the Extended Systems Monitor is similar. 

3) Saving BASIC; Writes a copy of M.BASIC plus the RES module 
onto a diskette. Used for creating a BASIC-only system 
diskette. 

B.l CALLING THE UTILITY 

1) Make sure you have mounted in drive an MDOS system 
diskette, or BASIC-only diskette with both M.BASIC and the 
BASIC Utility on it. 

2) Use normal operating procedures to get M.BASIC in control, 
indicated by the READY prompt. 

3) Enter the command LOAD "UTILITY* (return) . 

4) When the system responds with READY, enter RUN (return) . The 
Utility will sign on with: 

BASIC UTILITY PROGRAM-VERSION X.X 
ENTER KEY TO SELECT DESIRED FUNCTION 



F 


FORMAT DISK 


M 


MEM ] 


EXAM/MODIFY 


S 


SAVE 


BASIC 


S 


EXIT 




FUNCTION? 





5) To select a function, enter the associated letter, followed 
by a return. 

6) After completing a function, the program will request another 
command. Enter E^ to return to M.BASIC. 

7) If the program is for some reason unable to complete a 
function, it may return to the M.BASIC executive. To get 
back to the Utility, begin again at step 3, 
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B.2 INITIALIZING A DISKETTE - FUNCTION F 

The Utility refers to this as the FORMAT DISK function. 
Initialization consists of writing track and sector address 
information in each sector of the data area of the diskette and 
writing an empty Directory on the Directory track. 

Since initialization essentially erases a diskette, DO NOT 
initialize the System diskettes included with your system. 

1) In response to F (return) / the Utility will output: 
SPECIFY UNIT NUMBER? 

2) Enter the number of the drive to be used (0 to 3) and press 
return. The program responds with: 

INSERT BLANK DISKETTE IN UNIT X. 
ARE YOU READY? 

If you wish to get out of this function, press ( return) , 
otherwise, continue. 

3) Load the diskette you wish to initialize into the specified 
drive. 

4) Enter Y (return) . 

The Utility will initialize the diskette. This takes about 70 
seconds. 

When completed, the Utility will request the next function command. 

B.3 MEMORY SXAM/MODIFY - FUNCTION M 

In response to M (return) , the Utility will output: 

ENTER ADDRESS? 

Type the hexadecimal representation of the desired memory address 
followed by a carriage return. The Utility will print the 
hexadecimal value of the contents of the desired memory location, 
followed by a question mark (?). Enter one of the following 
responses: 

1) If a hexadecimal number from - PF followed by a carriage 
return is entered, the contents of the memory location just 
displayed are set to the value entered. The contents of the 
next sequential memory location are then displayed and the 
Utility prompts for the next response. 

2) If a carriage return only is entered, the contents of the 
next sequential memory location are displayed and the Utility 

prompts for the next response. 



B-2 Rev. 8.1 2/5/79 



3) If a colon (:) followed by a carriage return is entered, the 
Utility prompts for the entry of a new address to 
display/ modify as described above. 

4) If an exclamation mark (I) followed by a carriage return is 
entered, the Utility exits the memory modify/display function 
and prompts for a new function select. 

B.4 SAVE BASIC - FUNCTION S 

1) In response to S (return) , the Utility will output: 

ARE YOU READY? 

If you want to get out of this function, press ( return) , 
otherwise, continue. 

2) Mount the diskette on which you wish to store M. BASIC in 
drive 0. (The diskette MUST be newly initialized. If it is 
not, do section B.2 above, first.) 

3) Enter Y (return) . 

4) The Utility will save M. BASIC on the diskette, and set its 
attributes to permanent and write-protected. When completed, 
the Utility will request the next function command. 

5) If you wish to copy the BASIC. Utility onto the BASIC-only 
diskette, exit from the Utility by entering E^ as the next 
function. After the BASIC prompt READY, enter £AV^ 
■NiUTILITY" (return) . 

6) To copy any assembly language utility, such as DISKCOPY,' onto 
the BASIC-only diskette, use the FILECOPY command in MDOS. 
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APPENDIX C - ACCESSING DISKCOPY FROM BASIC 



DISKCOPY 1s a special overlay utility that writes an absolute binary copy 
of one disk onto another. The utility overlays MDOS or BASIC. It uses 
all available memory during the copying process. The more memory in a system 
the faster the copying process. On average it takes about two minutes to 
copy and verify all 315k bytes of a MOD II disk. 

NOTE 1: Previous versions of DISKCOPY will not run with BASIC 3.19 and 
DISKCOPY 3.i8 will not run with earlier versions of Micropolis 
BASIC. 

NOTE 2: In multiple drive systems DISKCOPY can be copied onto another 
disk by using the FILECOPY utility under MDOS (Section 4.7). 

The DISKCOPY utility is invoked from BASIC by using the LINK command. 

LINK "[unit:]OISKCOPY" 

a sign-on message is output: 

MICROPOLIS DISKCOPY VS X.X - COPYRIGHT 1978 

SPECIFY UNIT # FOR ORIGINAL (SOURCE) DISKEHE 
•? 

DISKCOPY waits until the unit number is entered. When a number between 
and 3 is entered it prompts: 

SPECIFY UNIT # FOR DESTINATION DISKETTE 
■> 

and waits until the unit number (0 to 3) is entered. It then prompts: 

PUT DISKETTES IN SPECIFIED UNITS 
TYPE Y WHEN READY 

and waits for a Y. A note of CAUTION, we strongly recommend placing a 
write protect tab on the original (source) diskette. It is possible to 
put the wrong diskette in the wrong drive or type the wrong unit numbers. 
If your original does not have a write protect tab and you make an error, 
the original can be overwritten. The write protect tab provides a physical 
Interlock which disables the write electronicSi 

When a Y is typed DISKCOPY will start the copying process. During copying, 
the process can be temporarily halted between read source and write destina- 
tion cycles by typing a control S. The process is restarted by typing any 
other key except a control C. 

The control C will cancel the entry or copy process and prompt: 

CANCELLED 
MORE ? 
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If a Y 1s typed DISKCOPY starts from the top asking for the unit numbers 
again. If an H 1s typed DISKCOPY prompts: 

PUT SYSTEM DISKETTE IN UNIT 

TYPE Y WHEN READY 

? 

When a Y is typed the disk In unit is rebooted. If It's an MDOS diskette 
MIX)S is booted. If the disk 1n unit Is a BASIC only disk or some other 
bootable system, it will be booted in and sign on. DISKCOPY is overlayed 
by the incoming system and is no longer in memory. 

When the disk has been copied and verified correctly DISKCOPY outputs: 

GOOD COPY 
TORE ? 

If the copy cannot be completed or does not verify correctly DISKCOPY outputs: 

PERM I/O ERROR ON DESTINATION DISKETTE 

or 

PERM I/O ERROR ON SOURCE DISKETTE 

indicating where the error occurred. 

It is possible for single drive systems to make use of the DISKCOPY utility 
to copy from one disk to another. In this case it is imperative that the 
original diskette be write protected with a write protect tab. The procedure 
involves specifying the same unit number for both source and destination 
disks. Immediately after typing a Y In response to the TYPE Y WHEN READY 
prompt, type a control S. The DISKCOPY program will read as many tracks from 
the source disk as can be contained In main memory and then pause- When the 
select indicator light goes out, remove the source diskette and Insert the 
destination diskette. Press the return key and as soon as the select 
Indicator light comes on type a control S again. When the select indicator 
light goes out again the data from the source disk has been written to the 
destination disk and one complete cycle is finished. This process is 
repeated, swaping the source and destination disks in and out until the 
entire disk is copied. After the last data is written onto the destination 
disk, the program goes directly into a verifying process and will not pause 
until this is over. When the source is placed back into the drive and the 
return key is pressed the system will prompt: GOOD COPY or output an error 
message as discussed above. At this point the copy is complete. 
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APPENDIX D - SUMtWRY OF MDOS ERROR MESSAGES 

D.I MDOS EXECUTIVE AND SHARED SUBROUTINES 

BAD FILE # 

The file nimiber specified 1s greater than 8. 

BAD RECORD # 

The record nunber specified is greater than exists In the specified file. 

CA-NCELLED 

A control C was typed at the console, canceling an operation. 

COMMAND NOT FOUND 

The word typed as a coniMnd name, or implicit command (file name) does 
not exist. The ctwinand was spelled incorrectly or the file name was 
not found on the specified dislc. 

DISK FULL 

An attempt was made to allocate an additional track to a file, and no 
free tracks exist. The file is closed and the message Is output. Some 
data may have been successfully written to the file before additional 
track space was needed. 

DRIVE NOT UP 

The disk unit specified is not loaded. 

DUPLICATE NAME 

The file name already exists on the unit specified. All files on a- disk 
must have unique names. 

END-FILE 

The end of the file has been reached during a disk read. 

FILE NOT FOUND 

The file name specified does not exist on the unit specified. 

FILE NOT OPEN 

The file with the specified number has not been opened. 
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INDEX PAST EOR 

The index position 1s beyond the end of the record. 

LOAD ADDRESS ERROR 

The address specified with a file to be loaded into memory would cause 
the file to overwrite the operating system. 

PARM ERR 

A parameter is out of range for a particular command, to big or to small. 
This is different than a syntax error caused by a parameter beyond the maximum 
input range. 

PERM FILE 

The file specified with a SCRATCH command or with the liSCRATCH subroutine 
has an attribute with bit 1 set high Indicating a permanent file. 

PERM I/O ERR 

A disk I/O error occurred which was not recoverable by the disk I/O retry 
logic. 

READ ONLY FILE 

The specified file has an attribute with bit set high. This Inhibits 
rewriting of the file. 

SYNTAX ERROR 

The syntax of a command is wrong. This may be due to incorrect spelling, 
or paraireters beyond the maximum input ranges-, 10 characters for ASCII 
and four hex digits for numeric. 

SYSTEM VERSION ERROR 

An attenpt was made to run a system program on the wrong version of the 
system. 

WRITE PROTECT 

The unit specified with a SAVE command or a subroutine that writes to the 
disk has a disk in it with a write protect tab In place. 

WRONG FILE TYPE 

The file type does not correspond to the type of operation that is to 
be performed. 

D.2 EDITOR 

FILEBUFFER OVERFLOW 
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This message occurs whenever there is less than 256 bytes of buffer space 
remaining in the edit buffer. Input can continue until the buffer is 
completely full, but the message will be repeated after each carriage 
return. The file should be written to disk and a new file started. If 
a file is loaded from disk and is too large to reside in the buffer, this 
message is output and the load is aborted. No data is loaded. This is 
most likely to occur in conjunction with the APPEND command. If an APPEND 
causes an overfollow, it is aborted and the files that were in the buffer 
prior to the command are not changed. 

FILE ON DISK NOT UPDATED, PROCEED? 

The current working file in the editor buffer has not been saved or resaved 
to disk. If you want to continue without updating the disk then type a Y 
in response, otherwise type an N. 

FILE NOT NAMED 

A name has not been given to the current editor file prior to trying to 
save it onto a disk. 

LINE NOT FOUND 

A line number which does not exist in the current text file was specified 
in an EDIT command. 

LINE NUr-IBER OVERaOW 

The editor coinnand RENUM specified an increment that caused the line number 
to exceed 9999 dednal. The file is only partially renumbered and care 
should be taken to do an additional RENUM with a smaller Increment to assure 
that the file is properly numbered prior to doing any editing on the file. 

STRING NOT FOUND 

The SEARCH MASK specified with a SEARCH or CHANGE command in the editor 
does not exist in the text. 

D.3 ASSEMBLER 

See Section 4.5.3. 
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APPENDIX E - RES. I/O SOURCE LISTING 

Addr Bl B2 B3 B4 E Line Label Oped Operand 



0000 




0000 




0000 




0000 




0000 




0000 




0000 




0000 




0000 




0000 




0000 


04EC 


0000 


04F0 


0000 


0502 


0000 


07 8D 


0000 


0792 


0000 


0797 


0000 


07E5 


0000 


07EA 


0000 


04EA 


0000 


04E7 


0000 




0000 




0000 




0000 


OOOD 


0000 


OOOA 


0000 


0008 


0000 


0003 


0000 


0013 


0000 


0015 


0000 


0018 


0000 


007F 


0000 


005F 


0000 




0000 


0010 


0000 




0000 


CODC 


0000 


C098 


0000 




0000 




0000 




0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 


0000 




0000 


0003 


0000 


0002 


0000 


0000 


0000 


0001 


0000 




0000 




0000 




0000 




04EC 





0010 

0020 

0030 

0040 

0050 

0060 

0070 

0080 

0090 

0100 

OHO 

0120 

0130 

0140 

0150 

0160 

0170 

0180 

0190 

0200 

0210 

0220 

0230 

0240 

0250 

0260 

0270 

0280 

0290 

0300 

0310 

0320 

0330 

0340 

0350 

0360 

0370 

0380 

0390 

0400 

0410 

0420 

0430 

0440 

0450 

0460 

0470 

0480 

0490 

0500 

0510 

0520 

0530 

0540 

0550 

0560 



I/O source file for Micropolis lES module 
on Vector M2, version 4.1 

by Neale Brassell, 
2/79 

Vector Graphic Inc. 

first, general system equates from SYSQ 



* 

* 
* 

* 

* 
* 

@CONSOLEADDR 

iCIOTABLE 

@LIOTABLE 

€CDIN 

eCDOUT 

iCDBEK. 

@LDOUT 

Sldatn 
Sdiport 

RES 

* 



EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 
EQU 



04ECH 
04F0H 
0502H 
078DH 
0792H 
0797H 
07E5H 
07EAH 
04EAH 
04E7H 



* now, general equates 
* 



CR EQU 

LF EQU 

BS EQU 

CNTC EQU 

CNTS EQU 

ONTO EQU 

CNTX EQU 

DEL EQU 

USCOEE EQU 
* 

CANCELLED EQU 

MIN EQU 

MOUl EQU 
* 

* Get printer etc. from user, and compute ports 

'Diablo 



ODH 
OAH 

08H 
03H 
13H 
15H 
18H 
7FH 
5FH 

OCODCH 
0C098H 



DIAB RIQ 

CENT REQ 

DECW REQ 

OTHR REQ 

BASE EEQ 

ANY EQU 

* 

SSTAT EQU BASE+3 

SDATA EQU BASE+2 

PSTAT EQU BASE 

PDATA EQU BASE+1 
* 

* Ok! first, the vectors to the i/o tables 
* 

ORG iCONSOLEADDR 



(1-Yes, 0=No):' 
'Centronics (l=Yes, 0=No) : ' 
'Decwriter, TTY, etc (1-Yes, 0»No) 
'Any other printer (l^Yes, 0=No):' 

'Bitstreamer base address:' 
DIAB! CENT ! DECW! OTHR 



; serial status 
; serial data 
; parallel 

; parallel 1 
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Addr Bl B2 B3 B4 E Line Label 



Oped Operand 



04EC FO 
04EE 02 
04FQ 
04F0 
04F0 
04F0 
04F0 
04F0 14 
04F2 2E 
04F4 77 
04F6 F8 
04F8 00 
04FA 04 
04FC OF 
04FE 
04FE 00 
04FF 01 

0500 4F 

0501 03 
0502 
0502 
0502 
0502 
0502 

0502 00 
0504 8E 
0506 M 
0508 00 
050A 27 
050C 11 
050E 13 
0510 

0510 00 

0511 01 

0512 83 

0513 01 
0514 
0514 
0514 
0514 
0514 

0514 CD 

0517 78 

0518 FE 
05 lA C8 
051B FE 
05 ID G2 
0520 06 
0522 FE 
0524 CA 
0527 EE 
0529 CO 
05 2A 06 
052C 3C 
052D C9 
052E 



04 

05 



05 
05 
05 
05 
06 
06 
06 



00 
05 
05 
00 
06 
06 
06 



8D 07 

03 

15 

22 05 
18 

5F 

2A 05 
7F 

08 



0570 
0580 
0590 
0600 
0610 
0620 
0630 
0640 
0650 
0660 
0670 
0680 
0690 
0700 
0710 
0720 
0730 
0740 
0750 
0760 
0770 
0780 
0790 
0800 
0810 
0820 
0830 
0840 
0850 
0860 
0870 
0880 
0890 
0900 
0910 
0920 
0930 
0940 
0950 
0960 
0970 
0980 
0990 
1000 
1010 
1020 
1030 
1040 
1050 
1060 
1070 
1080 
1090 
1100 
1110 
1120 





DW 


@CIOTABLE 


1c 


DW 


Sliotable 


* the console 


i/o 


table 


A 


OKC 


SCIOTABLE 




DW 


CIN 




DW 


GOUT 




DW 


CBRK 




DW 


CDIN 




DW 


CDOUT 




DW 


CDBRK 


■k 


DW 


CDINIT 


WRAPFLAG 


DB 





NULLCT 


DB 


1 


WIDTH 


DB 


79 


CURSOR 


DB 


3 



* next, the list i/o table 
* 



ORG 

DW 
DW 
DW 
DW 
DW 
DW 
DW 

DB 
DB 
DB 

DB 



ILIOTABLE 


LOUT 

LAIN 



LDOUT 

LDATN 

LDINIT 


1 

131 
1 



PWRAPFLAG 

PNULLCT 

PWIDTH 

PCURSOR 

* 

* now for the logical i/o routines 

* {CIN} logical console input 

CIl 



; logical input 

; logical output 

;logigal break check 

; physical input 

; physical output 

; physical break check 

iphysical initialization 

; wraparound flag 
;null count (+1) 
;width (-1) 
; cursor position 



; placeholder for input 

; logical output 

; logical attention check 

J placeholder for input 

; physical output 

; physical attention check 

; physical initialization 

; wraparound flag 
;null count (+1) 
;Midth (-1) 
;line position 



BSPCE 



CALL 


SCDIN 


;get character 


MOV 


A,B 




CPI 


CNTC 


rc? 


RZ 




; re turn if so 


CPI 


CNTU 


ru? 


JNZ 


$+5 




MVI 


B.CNTX 


;xlate ~U into ''X 


CPI 


USCORE 


; underscore? 


JZ 


BSPCE 




ZRI 


DEL 


;DEL? 


RNZ 






MVI 


B,BS 


;aake backspace 


INR 


A 


; force NZ 


RET 
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Addr Bl 


B2 


B3 B4 


E Line 


Label 


052E 






1130 


* {COUT} 


052E 






1140 


* 


052E ED 


5B 


FE 04 


1150 


COUT 


0532 2A 


00 


05 


1160 




0535 78 






1170 




0536 FE 


OA 




1180 




0538 CA 


92 


07 


1190 




053B FE 


OD 




1200 




053D CA 


5F 


05 


1210 




0540 FE 


18 




1220 




0542 CA 


6F 


05 


1230 




0545 FE 


08 




1240 




0547 C2 


4D 


05 


1250 




054A 25 






1260 




054B 25 






1270 




054C 00 






1280 




054D CD 


92 


07 


1290 


COUTl 


0550 7B 






1300 


WRAP 


0551 B7 






1310 




0552 CO 






1320 




0553 7C 






1330 




0554 BD 






1340 




0555 C2 


69 


05 


1350 




0558 06 


OD 




1360 


CCRLF 


055A CD 


92 


07 


1370 




055D 06 


OA 




1380 




055F CD 


92 


07 


1390 


CROUT 


0562 06 


00 




1400 




0564 15 






1410 




0565 C2 


5F 


05 


1420 




0568 AF 






1430 




0569 3C 






1440 


DONE 


056A 32 


01 


05 


1450 




056D B7 






1460 




056E C9 






1470 




056F 06 


5C 




1480 


CNTXOOT 


0571 CD 


92 


07 


1490 




0574 C3 


58 


05 


1500 




0577 






1510 


* 


0577 






1520 


* {CBRK} 


0577 






1530 


* 


0577 CD 


97 


07 


1540 


CBRK 


057A CO 






1550 




057B 78 






1560 




057C FE 


13 




1570 




057E C2 


89 


05 


1580 




0581 CD 


8D 


07 


1590 


PAUSE 


0584 FE 


13 




1600 




0586 CA 


81 


05 


1610 




0589 FE 


03 




1620 


CANC 


058B 3E 


10 




1630 




058D C9 






1640 




058E 






1650 


* 


058E 






1660 


* {LOUT} 


058E 






1670 


* 


058E ED 


SB 


10 05 


1680 


LOUT 


REV. 8 


.1 


2/5/ 


79 





Oped Operand 
logical console output 



LDED 


WEAPFLAG 


LHLD 


WIDTH 


MO? 


A,B 


CPI 


LF 


JZ 


iCDOUT 


CPI 


CR 


JZ 


ClOUT 


CPI 


CNTX 


JZ 


CNTXOUT 


CPI 


BS 


JNZ 


COUTl 


DCR 


H 


DCR 


H 


NOP 




CALL 


SCDOUT 


MOV 


A,E 


OlA 


A 


1N2 




MOV 


A,H 


CHP 


L 


JNZ 


DONE 


MVI 


B,CR 


CALL 


SCDOUT 


MVI 


B,LF 


CAT.T, 


@CDOUT 


MVI 


B,0 


DCR 


D 


JNZ 


CROUT 


XEA 


A 


INE 


A 


STA 


CURSOR 


ORA 


A 


KET 




MVI 


B,'\' 


CALL 


eCDOUT 


JMP 


CCRLF 



;get wrap, null, width, cursor 
get character 

linefeed? 

output, ignor if so 

return? 

handle special 
"X character? 
handle special also 

print if not BS 

adjust cursor counter 
(space for patch) 

print character 
get wrap flag 

return if no wrap 
get cursor 

end of line? 
J done if not 

; print LF 

;and CR 

;make a null 
;decreiient counter 
jloop 

; increment cursor ptr -- 
;save 

I return 

; print \ instead of "X 

;go print CRLF 



logical console break check 



CALL 


eCDBRK 




RNZ 




J return if no char 


MOV 


A,B 


;get char 


CPI 


CNTS 


;"S? 


JNZ 


CANC 




CALL 


@CDIN 


;get char 


CPI 


CNTS 


; another "S? 


JZ 


PAUSE 




CPI 


CNTC 


rc? 


MVI 


A, CANCELLED 


; error code, just in case 


RET 




: return 



logical list output 

LDED PWRAPFLAG 
E-3 



;get wrap, nulls 



Addr 


Bl 


B2 


B3 B4 


E Line 


Label 


Oped 


Operand 




0592 


2A 


12 


05 


1690 




LHT.n 


PWIDTH 


;and width, cursor 


0595 


78 






1700 




MOV 


A,B 




0596 


FE 


OA 




1710 




CPI 


LF 


; linefeed? 


0598 


C2 


A2 


05 


1720 




JNZ 


LOUTO 




059B 


CD 


E5 


07 


1730 




CALL 


ILDOUT 


; print directly if LF 


059E 


DA 


EE 


05 


1740 




JC 


ATT 


; handle if ATTN 


05A1 


C9 






1750 




RET 






05A2 


FE 


OD 




1760 


LOUTO 


CPI 


CR 


; return? 


05A4 


CA 


CC 


05 


1770 




JZ 


LCROUT 




05A7 


FE 


18 




1780 




CPI 


CNTX 


j'X character? 


05A9 


CA 


DF 


05 


1790 




JZ 


LCNTXOUT 




05AC 


FE 


08 




1800 




CPI 


BS 


; backspace? 


05AE 


C2 


B4 


05 


1810 




JNZ 


LOUTl 




05B1 


25 






1820 




DCR 


H 


; adjust cursor 


05B2 


25 






1830 




DCR 


H 




05B3 


00 






1840 




NOP 




;(spot for patch) 


05B4 


CD 


E5 


07 


1850 


LOUTl 


CAT.T, 


@LDOUT 


; print character 


05B7 


DA 


EE 


05 


1860 




JC 


ATT 


5 handle If ATTN 


05BA 


7B 






1870 


LWRAP 


MOV 


A,E 


jwraparound? 


05BB 


B7 






1880 




ORA 


A 




05BC 


CO 






1890 




SNZ 




; re turn if not 


05BD 


7C 






1900 




MOV 


A,H 


;get cursor 


05BE 


BD 






1910 




CMP 


L 


|too far right? 


05BF 


C2 


D9 


05 


1920 




JNZ 


LDONE 




05C2 


06 


OD 




1930 


LCILF 


MI 


B,CR 




05C4 


CD 


15 


07 


1940 




CALL 


Sldout 


; print LF 


05C7 


DA 


EE 


05 


1950 




JC 


ATT 


; check ATTN 


05CA 


06 


OA 




1960 




MVI 


B,LF 




05CC 


CD 


E5 


07 


1970 


LCROUT 


CALL 


dLDOUT 


; print CR 


05CP 


DA 


EE 


05 


1980 




JC 


ATT 




05D2 


06 


00 




1990 




MVI 


B,0 


; create a null 


05D4 


15 






2000 




DCR 


D 


; count 


05D5 


C2 


CC 


05 


2010 




JNZ 


LCROUT 


; print nulls 


05D8 


AF 






2020 




XRA 


A 




05D9 


3C 






2030 


LDONE 


INR 


A 


;inc cursor 


05DA 


32 


13 


05 


2040 




STA 


PCURSOl 


;save it 


05DD 


B7 






2050 




ORA 


A 




05DE 


C9 






2060 




RET 




; return 


05DF 


06 


5C 




2070 


LCNTXOUT 


MVI 


B/\' 


;xlate here , too 


05E1 


CD 


E5 


07 


2080 




GALL 


@LDOUT 


; print 


05E4 


D2 


C2 


05 


2090 




JNC 


LCRLF 


; handle CRLF if no ATTN 


05E7 


C3 


EE 


05 


2100 




JMP 


ATT 


;go to ATTN routine 


05EA 








2110 


* 








05EA 








2120 


* {LAIN) list 


logical 


attention 


check 


05EA 








2130 


* 








05EA 


CD 


EA 07 


2140 


LATN 


CALL 


@LDATN 


;do it 


OSEE 


DO 






2150 




RNC 




;done if NC 


05EE 


21 


EA 


04 


2160 


ATT 


LXI 


H,@D1P0RT 


;on ATTN, 


05F1 


3E 


01 




2170 




MVI 


A.l 


; reset 


05F3 


77 






2180 




MOV 


M,A 


; assignments 


05F4 


3C 






2190 




INR 


A 


; to their 


05F5 


23 






2200 




INX 


H 


; defaults. 


05F6 


77 






2210 




MOV 


M,A 


; and indicate 


05F7 


C9 






2220 




RET 




; an error . 


05F8 








2230 


* 
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Addr Bl B2 B3 B4 E Line Label 



Oped Operand 



05F8 2250 

05F8 2260 

05F8 2270 

05F8 2280 

05F8 2290 

05F8 CD DC CO 2300 

05FB CA F8 05 2310 

05FE 47 2320 

05FF C9 2330 

0600 2340 

0600 2350 

0600 2360 

0600 78 2370 

0601 C3 98 CO 2380 
0604 2390 
0604 2400 
0604 2410 
0604 CD DC CO 2420 
0607 CA OD 06 2430 
060A 47 2440 
060B AF 2450 
060C C9 2460 
060D 3C 2470 
060E C9 2480 
060F 2490 
060F 2500 
060F 2510 
060F AF 2520 

0610 C9 2530 

0611 2540 



* now for the physical i/o drivers 
* 

* {COIN} physical console input 
* 

CDIN CALL MIN 

JZ CDIN 
MOV B,A 
RET 

* 

* {CDOUT} physical console output 
* 



CDOUT 



M0¥ 

JMP 



A,B 
MOUT 



;get stat/char 
;none yet 

J satisfy requirements 
; that's that 



;get character 
;go print it 



* {CDBRK} physical console break check 
* 

CDBRK 



CALL 


MIN 


;get stat/char 


J2 


CBl 


;no char 


MO? 


B,A 


;save char 


XIA 


A 


;set Z 


BET 




; return 


INR 


A 


; clear Z 


RET 




J and return 



CBl 



*. {CDINIT} physical console initialization 

it 



CDINIT 
* 



XRA 

RET 



; clear CY 

; console is always init'ed 
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Addr Bl B2 B3 B4 E Line Label 



Oped Operand 



0611 
0611 
06U 
0611 
0611 
0611 
0612 
0613 
0613 
0613 
0613 
0614 
0616 
0618 
061A 
061C 
061E 
0620 
0622 
0624 
0626 
0627 
0627 
0627 
0627 
062A 
062B 
062B 
062B 
062B 
062B 
062B 
062B 
062B 
062B 
062B 
062B 
062B 
062B 
062B 
062B 
062B 
062B 
062B 
062B 
062B 
062B 
062B 
062B 
062B 
062B 
062B 
062B 
062B 
062B 
062B 



AF 
C9 



AF 

D3 03 
D3 03 
D3 03 
3E 40 
D3 03 
3E CI 
D3 03 
3E 27 
D3 03 
C9 



CD EA 07 
D8 



2560 
2570 
2580 
2590 
2600 
2610 
2620 
2630 
2640 
2650 
2660 
2670 
2680 
2690 
2700 
2710 
2720 
2730 
2740 
2750 
2760 
2770 
2780 
2790 
2800 
2810 
2820 
2830 
2840 
2850 
2860 
2870 
2880 
2890 
2900 
2910 
2920 
2930 
2940 
2950 
2960 
2970 
2980 
2990 
3000 
3010 
3020 
3030 
3040 
3050 
3060 
3070 
3080 
3090 
3100 
3110 



* Now for the physical list routines. 



* {LDATl} physical list ATTN check 



LDATN 



XRA 

RET 



;none of our devices 
; have this feature 



* {LDINIT} physical list initialization 

* 



LDINIT 



XRA 


A 


OUT 


SSTAT 


OUT 


SSTAT 


OUT 


SSTAT 


mi 


A,40H 


OUT 


SSTAT 


MVI 


A,OCEH 


OUT 


SSTAT 


MVI 


A,27H 


OUT 


SSTAT 


RET 





* {LDOOT} physical list output 
* 



LDOUT 



* 
LOl 



CALL 
RC 

IFT 

PIT 

IN 

HAR 

JNC 

MO? 

OUT 

XRA 

RET 

END IF 



(iLDATN 



DECW 



'General selected' 



;send nulls 

;send reset 
;send mode 

;send command 
J return 

; formality 

J if TTI, Decwrltar, etc. 



SSTAT 

LOl 
A,B 

SDATA 
A 



LOl 



L02 



IFT 


DIAB 


PRT 


'DiabL 


IN 


SSTAT 


EAR 




JNC 


LOl - 


MOV 


A,B 


OUT 


SDATA 


CPI 


LF 


JNZ 


XAIET 


MVI 


B.CNTC 


CALL 


LDOUT 


IN 


SSTAT 


ANI 


2 


JZ 


L02 


IN 


SDATA 



;get status 

;wait till ready 

; output data 
; clear C 
; return 



;if Diablo 



;get status 

jwait till ready 

; output character 
; linefeed? 
;retum if not 
;send ETX char 

;get return status 

;walt till reply ready 
;get reply 
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Addr Bl B2 B3 B4 E Line Label 



Oped Operand 



062B 


3120 




MVI 


B,LF 




jrestore LF 


062B 


3130 


XAIET 


XRA 


A 




;2ap carry flag 


062B 


3140 




RET 






jreturn 


062B 


3150 


* 










062B 


3160 




END IF 








062B 


3170 


* 










062B 


3180 




IFT 


CENT 




;if Centronics 


062B 


3190 




PRT 


'Centronics 


selected' 


062B 


3200 


* 










062B 


3210 


LOl 


IN 


PDATA 




;get status 


062B 


3220 




EAR 








062B 


3230 




JC 


LOl 




;wait till not busy 


062B 


3240 




M0¥ 


A,B 






062B 


3250 




ORI 


128 




; strobe on 


062B 


3260 




OUT 


PDATA 






062B 


3270 




MI 


12? 




; strobe off 


062B 


3280 




ODT 


PDATA 






062B 


3290 




ORI 


128 




J strobe on 


062B 


3300 




OUT 


PDATA 






062B 


3310 




XRA 


A 




; clear C flag 


062B 


3320 




RET 






1 return 


062B 


3330 


* 










062B 


3340 




ENDII 








062B 


3350 


* — 










062B 


3360 




IFF 


ANY 




;if no printer at a. 


062B 


3370 




PRT 


'No printer' 




062B 


3380 


* 










062B C3 92 0? 


3390 


LOl 


JMP 


SCDOUT 




idtmmy routine 


062E 


3400 


* 










062E 


3410 




END IF 








062E 


3420 


* 










062E 


3430 


* 








' 


062E 


3440 




IFT 


OTHR 




1 special driver 


062E 


3450 




PRT 


'Special 


printer' 


062E 


3460 


* 










062E 


3470 


LOl 


BET 






;user must write spt 


06 2E 


3480 


* 










062E 


3490 




END IF 








062E 


3500 


* 










062E 


3510 


* 










062E 


3520 




PRT 


'End - ' , 


.$ 




062E 


3530 


* 










062E 


3540 




END 


RES 
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APPENDIX F - MICROPOLIS DISK BOOTSTRAP 



The Micropolls Disk Bootstrap Pnjgram resides in PROM on the controller 
B board, occupying the first 512 bytes of the controller address space. 
The bootstrap is involved by starting program execution at the base address 
of the controller. An address-Independent relocator determines the controller 
base address and moves the bootstrap code from PROM to low RAM system 
memory where it is executed. The Bootstrap Program selects drive unit 
and reads the contents of sector of track (the System Loader Program) 
into memory. Sector must be formatted as described In Section 6.1.2 
and must be organized as follows: 

Byte Track ID 

Byte 1 Sector 10 

Byte 2-11 (Ignored) 

Byte 12-265 System Loader Program 

Byte 266-267 Load Address 

Sector Is read into RAM at the system loader origin specified by bytes 
266 and 267. After a successful read, the bootstrap transfers control to 
load address +12. The DE register pair will contain the controller base 
address. 

The Bootstrap Program requires approximately IK of RAM memory from address 
90H. 
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F40e 



F620 



pe02 

F602 



reae 



0040 
0080 
3020 



F601 



* 

* 
* 
* 



HICHOPOLIS DISK BOOTSTlAP 

VEESION 2 — HELOCATABLE 
BOOfSTtAP - OPEHATES WITH 
CONTIOLLEH STRAPPED FOR ANY 
LOCATION FROM C00ai-FC00H 

PICH PART NUMBEBS: 

HIGH 800303-01 -4C 
LOV 800003-02-2C 

ISLEASE 1.0 
COPTIIGHT MIGHCPOLIS COPPOIATION 
OCTOBER 11 1977 



* 

* 
« 



EQtl X 'F400 ' 

BIFINITIONS GIVEM FOR STANDARD 

ADDRESS OF F400I — CONTROLLER 

MAI ACTUALLT BE STRAPPED FOR 

ANT IK BOUNDART FROM Ca00H -FC00H 

EQU BPROM+X'0200' 

DATA REGISTERS 



* REGISTER DEFINITIONS AND * 

* FLAG EQUATES FOR MICROPOLIS * 

* FLEXIBLE DISK CONTROLLER B * 

* 

BPROK 
* 

* 
* 
* 
DISK 

WDATA 
RDATA 

DSECTR 

* 
* 

« 

* 

* 

SIFLG 

SFLG 

DTMR 

DSTAT 



EQU 
£QU 



DISK+X'02' 

¥DATA 



STATUS REGISTERS 



ECU 
'3 
i 
5 
S 
7 



DISK 

SECTOR COUNT 

SPARE 

SPARE 

SCTE iNTERBUPf FLAG 

SECTOR FLAG 



FLAG BITS 



ECU 
EQU 
EQU 



x'4a 

X'30 
X'20 



EQU DISK+1 
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* d' 


-1 UNIT ADDRESS 




* 


2 UNIT SELECTED (lOW THUI) 




1^ 


3 THACK 




* 


4 WHITE PROTECT 




lit 


5 DISK READY 




» 


6 PINTE 




* 
4 


7 THAN Sf El FLAG 




* 


FLAG BITS 


0080 


TUG 


EQU I'm' 


2040 


IMTE 


EOU X'40' 


dBcS 


lEI 


EQU X'23' 


0010 


W?T 


EQU X'10' 


0008 


TK0 


lOU X'08' 


0004 


USLT 
* 


EQU X'04' 




* 
* 

1>: 


COMMAND HEGISTEE 


F600 


DCMKE 


EQU DISK 




*(ALSO WILL lESPOND TO DISS+1) 




* 


-1 COMMAND MODITIEE 




* 5 


-7 COMMAND 




itr 


COMMANDS 


3020 


SLUN 


IQU X'20' SELECT UNIT 




« 


MOriFIiH CONTAINS UNIT ADDRESS 


0040 


SINT 


ECU X'4a' SET INTERRUPT 




« 


MODIFIER =1 EMA3LE INTERRUPT 




« 


=0 DISABLE INTERRUPT 


0060 


STIP 


EQU X'60' STEP CARRIAGE 




* 


MODIFIER =03 STEP OUT 




* 


=01 STEP IN 


0080 


¥11 TE 


EOU X'80' ENABLE VRITE 




# 


NO MODIFIER USED 


00A0 


El SET 


ECU X'A0' RESET CONTROLLER 




* 


NO MOriFIER USED 




* 

3^ 


DISK PARAMETERS 


0001 


SDLT 


SOU 15 STEP+SETTLE TIME 




« 


DIVIDED BT 2.6775 


0086 


BITOT 


EOU 134 BYTCT/2 




* 




* 


* 




# 


PROM-RESIDENT BOOTSTRAP * 




« 


* 




* 

* 


]«c «9;c <: 3^» :^«>»ci^«a»!«#;ic«i4(* 1^ ^#i«i « « « « 3^« :^« :fe #9ji 




BOOTSTRAP REQUIRES AT LEAST IS 




« 


OF HAM MEMORY FROM 901 
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RELOCATES FIOM 


PROM INTO HAM THEN 






« 


100TSTF.A? LOADS SECTOR ZER0 OF 






* 


TRACK ZERO INTO RAK AND STARTS 






# 


THE PROGRAM LOADED 








SECTOR ZE13 IS 


ORGANIZED AS 






# 


FOLLOWS: 








* 


BITES a-1 


HEADER 






* 


ITTIS 2-265 


USEP PHOGRAK 








BYTES 266-267 


RAM ADDRESS 






« 


BOOTSTRAP WILl 


READ SECTOR ZERO 






* 


INTO 


RAM STARTING AT THE 






* 


ADDRESS SPECIFIED BT BYTES 






* 


266 & 267 AND \ 


•(ILL START 






* 
* 


TEE PROGRAM AT 


RAM ADDRESS +12 


00A0 




CfCHG 

4c 


ECU 


X'A0' 


CONTROLLER BASE 
ADDRESS SAVED HERE 


0000 




# 


ORG 


CTORG-X'35' CT0BG+2-RLCLEN) 






* 


SELOCATOR — r.i 


D7ES BOOTSTRAP INTO 






* 


RA^1 AND STARTS 


BOOTSTRAP 


3061 


13 


RELOC 


DI 






006C 


21A200 




LXI 


H.CTORG+2 


STUFF A RETURN IN 


i06F 


F9 




SPIL 




RAM AND CALL IT TO 


0070 


36 C9 




mi 


M,X'C9' 


DETERMINE ADDRESS 


00 ?2 


CDA200 




CALL 


CTORG+2 


OF CONTROLLER 


0075 


EB 




ICHG 




SAVE RAM ADDl 


0076 


2iA0e0 




LHLD 


CTORG 


GET ADDRESS ¥HICE 


0079 


2100 




M7I 


L.0 


WAS PUSHED ON STAC 


0071 


E5 




PUSH 


H 


MSB IS CTLR ADDR 


00 7C 


011D00 




LXI 


B,BTDSP1 


BUILD MOVE LOOP 


0071 


09 




DAD 


B 


ADDRESS 


00-80 


E5 




PUSH 


5 


STUFF ON STACK 


0081 


El 




POP 


H 


ADJUST SP 


2082 


0I1A 




mi 


C,BTDSP2 


BUMP HL TO START 


00S4 


09 




DAD 


B 


OF BOOT CODE 


0085 


06BD 




mi 


B.BTLEN 




0087 


EB 




ICHG 






0088 


3B 


11010 


DCX 


SP 


ADJUST SP TO POINT 


0069 


3S 




DCX 


SP 


TO RE010 ON STACK 


00 8A 


lA 




LBAX 


D 


MOVE BYTE FROM 


30 S3 


77 


^ 


MO? 


M.A 


PROM TO RAM 






« 


COMPARE MERORY 


WITH A REG — 






* 


IF DIFFEBINT THEN DESTINATION 






« 


RAM : 


IS BAD OR 


IS PROM — 






« 


EELOCATOR WILL 


LOOP IN MOVE 






* 

* 


LOOP 


UNTIL SUCCESSFUL 



008C II 



CMP M 



GOOD MOTE? 
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0081 


C0 




RNZ 




NO-LOO? 


00 8E 


23 




INX 


H 




008f 


13 




INX 


D 




0092 


05 




ECl 


3 


DONE? 


0091 


C0 




HNZ 




NO-lOO? 


0092 


El 




POP 


H 


YES-CLEAN UP STAC 


0093 


2AA000 




LHLD 


CfCBG 


BUILD CONTROLLER 


0096 


110002 




LXI 


D,X'200' 


ADDRESS FROM BASE 


00S9 


19 




DAB 


D 




00 9A 


22A200 




SHLD 


DADE 


AND SAVE 


30 9r 


36A0 




M7I 


M, RESET 


RESIT CONTROLLER 


00 9? 


C3D400 


iS; 


J MP 


SL013 


AND GO START BOOT 


001D 




iTrspi 


EC'U 


1E010-EELOC 


001 A 




1TDSP2 


E2U 


*-RE010 




0037 




mCLEK 


IQU 


*-IILOC 




00A2 




lOOT 


ECU 


* 




00A£ 




I km 


DS 


2 




00A4 




IDEST 
* 


DS 


2 








* 
* 
* 


READ 


1 SECTOR 








* 


B -SECTOR 








* 


C=BYTECOUNT /2 








# 
# 


DE=READ lUFESl 








* 


A, HI 


ARE DESTROTID 






« 


HETUIKS Z=OK 








* 




NZ=EREOR 






* 


WAIT 


FOR DESIRED SECTOR 


30Ae 


2AA200 


irsEC 


LHLD 


DADR 




00A9 


7E 




MCV 


A,M 


WAIT SCTF FLAG 


00AA 


E680 




ANI 


SFLG 




00AC 


CAA900 




JZ 


RDSEC+3 




00AI 


7E 




r^ov 


k,f. 


OK -IS THIS THE 


0010 


E60F 




ANI 


X'0P' 


DESIRED SCTR? 


0032 


A8 




IRA 


B 




00B3 


C2A900 


# 


JNZ 


RDSEC+3 


MO -WAIT 






* 


FOUKD DESIRED 


SECTOR GO HEAD 


00B6 


23 


* 


INX 


H 




0017 


16 


ED 005 


OR A 


f^ 


WAIT FOR TRANSFER 
FLAG 


0018 


F2B700 


* 


JP 


RD005 

^VV.'S 7T. «« 


cir<r-«TPTP 
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if 


SYNC 


BYTE 






00B1 


23 




I NX 


S 






001C 


71 




HOT 


A.M 


READ SYNC BYTI 




00BD 


AI 




XRA 


A 


CLEAR CARRY 




0011 


El 




XCHG 








0011 


0600 




MTl 


1,0 


AND CIECISUM 




00CI 


00 




NOP 








30C2 


m 




NO? 
HEAD 


LOOP 






00C2 


lA 


ED010 


LDAX 


D 


READ FROM DISK 




00C4 


77 




HOY 


H.A 


MOVE TO BUFEEE 




00C5 


23 




INX 


H 


NEXT LOC 




00C6 


88 




ADC 


1 


ADD TO CHECKSUM 




00C? 


47 




HOT 


B.A 


AND SAVE 




0iC8 


lA 




LDAX 


D 


NEXT READ 




00 C9 


77 




MOV 


M.A 


-ITC- 




00 CA 


23 




INX 


H 






00CB 


as 




ADC 


B 






00CC 


47 




MOV 


B,A 






20CC 


0D 




DCR 


C 


END Of DATA? 




00CI 


C2C30a 


^ 


JNZ 


HD010 


NO-LOOP 








* 
# 


END ( 


DF DATA-EEAD CHECKSTIM 




30E1 


lA 




LDAX 


B 






00l>2 


18 




CMP 


B 


COMPARE VI TH 




00D2 


C9 


* 

* 

* 
* 


BET 
SELII 


3T DRIVE a 


COMPUTED CHECKSW 




20 D4 


2AA200 


* 
SL010 


LHLE 


DADH 


SELECT DPIVE 




03C7 


3620 




K7I 


M.SLtIN 






00DS 


23 




INX 


H 






20t'A 


7£ 




MOV 


A,M 






00DB 


21 




DCX 


H 






00DC 


£624 




ANI 


RDY+USIT 


CHECK SLTD & RDY 




00DE 


EE2i 




XII 


RDY 


WAIT ONTIL OK 




0010 


C2D400 


* 


JNZ 


SLai0 


TO PROCEED 
WAIT 250 MSEC 




0013 


0E5E 




MVI 


C,94 


TOR SECTOR CNTR 




00E5 


CD4901 




CALL 


TIMER 


TO SYNC 




00 £8 


23 


SL020 


INX 


a 






00 £S 


7E 




MOV 


A.M 


READ STATUS AGAIN 




00 £A 


21 




DCX 


E 






00 £1 


£624 




ANI 


RDY+USLT 


TO ENSURE STILL 




0011! 


££20 




XEI 


EDY 


OK TO PROCEED 




00 IT 


C21400 




JHZ 


SL010 


NO-TRY AGAIN 
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* 

4 


EESTCIE DHHE 


TO TRACK 3 


0012 23 


CZEBC 


INX 


u 


READ STATUS 


0012 7E 




.^'OV 


A.M 




2014 £638 




ANI 


Tr3 


TRACK 0? 


03 F6 2B 




DCX 


H 




20F? CA27ai 


:^ 


JZ 


CZ030 


KO-PEESS CM 




* 


IF ALEiADT Af 


TRACK ZERO 




« 


STEP 


IN THEN ; 


BACK OUT 




* 

Ik 


TG ENSUHE A GOOD POSITION 


00 lA 0606 


V 


mi 


B,8 


STEP IN 5 TKS 


00IC 3661 


C2010 


mi 


f^.STEP*! 


STEP IN 


00 n 0E0J 




mi 


C.SDLT 


DELAY SEES + 


0100 CD4901 




CALL 


TIMEl 


SETTLE TIME 


3103 05 


CZ020 


DCE 


1 




0104 C2IC30 


iH 


JN2 


CZ010 


LOOP UNTIL IN 


3107 23 


CZ030 


INX 


H 


HEAD STATUS 


€108 7E 




MO? 


A,M 


TRACK 0? 


0109 £608 




ANI 


TEa 




ZieB 2B 




BGX 


H 




3iaC C21901 




JNZ 


SSZEIO 


YES-PEESS ON 


0101 3660 




M?I 


M.STIP 


NO-STEP OUT 


3111 0E0F 




?^VI 


C.SDLT 


DELAY 


0112 CD4901 




CALL 


TIMES 


THEN TEST AGAIN 


0116 C20701 


# 


jy.f 


CZ030 






* 


READ 


THECUGE 


SECTOR ZERO 




■* 


ONI ' 


riME TO FIND BAM ADDRESS 




* 

3^ 


THEN 


READ PROGRAM IN & START 


011S 215F01 


ESZIIO 


LXI 


H.BTlUr 




011C CC3701 




CALL 


RZEI0 


READ SCTR ZEEO- 


0111 C2C400 




JNZ 


SL013 


EESEEK If HDB BAD 


0122 2A6902 




LHLD 


BTmF+266 GET PGM ADDRESS 


0125 22A400 




SHLD 


LDRST 


GO LOAD PGf^ 


0128 CE3701 




CALL 


RZE10 




012B C2D400 




JNZ 


SL013 


BESEEI IF HDB BAD 


0121 2AA4e0 




LHLE 


LDBST 


COMPUTE STABT 


0131 110C00 




LXI 


D,12 


ADDRESS AND GO 


0134 19 




DAD 


D 


START PIOGRAM 


0135 m 




POP 


D 


(CTLR CBG STILL 


0136 19 


4 


PGHL 




ON STACK) 


0137 15 


BZ1B0 


PUSH 


E 


SAVE PAM ADDRESS 


0136 EB 




XCHG 




DE<-ADDE£SS 


0139 018600 




IX I 


B.BTTCT 




ai3C CDA600 




CALL 


RDSIC 


READ IN SECTOR 


013F n 




POP 


E 




0142 023701 




JKZ 


RZEE0 


RETRY IF CISUM EEH 


0143 £5 




PUSH 


E 




0144 71 




?^0¥ 


A.K 


CHECK HEADER 


0145 23 




INX 


H 




0146 16 




CIA 


M 
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APPENDIX G - "FEATURES" PROGRAM TO OPTIONALLY SHORTEN BASIC 

M.BASIC contains features which are very useful during program 
development but unnecessary when running debugged production 
programs. It is possible to selectively delete some or all of these 
features. When these features are removed the program buffer 
(user's program space) is enlarged. Without removing them, the 
program buffer begins at 5D86 (Hex) whereas when all the features 
which can be removed are removed, the program buffer begins at 5700. 
This is the same place it did in version 3.0 of M.BASIC. 

A special assembly languge program called FEATURES is supplied to 
selectively remove features from BASIC. The three features which 
can be removed are MERGE, RENUM, and EDIT. The procedure is as 
follows: 

1) Load BASIC fron an MDOS system diskette or from a BASIC-only 
diskette. This must be BASIC version 4.0. 

2) Type LINK "FEATURES" then depress (return) . 

3) The program will then begin by displaying: 
BASIC V.S. 4.0 FEATURES PROGRAM 

ENTER NUMBER OF DESIRED FUNCTION (CONTROL-C TO EXIT) 

1 -REMOVE MERGE 

2-REMOVE RENUM AND MERGE 

3-REMOVE EDIT, RENUM AND MERGE 



4) Select the desired function and enter its number. You have 
only the 3 choices given. The program will begin executing 
as soon as you touch one of the number keys. If you want to 
return to BASIC rather than executing the program, depress 
control-C (hold CTRL key down while depressing the letter C) 
instead of one of the numbers. 

5) When the selected features are removed, the system is 
returned to BASIC automatically. 

NOTE: If you run the FEATURES program using a disk whose BASIC is 
already shortened and if you select any of the features which had 
been removed, then the program will set the beginning of the program 
buffer back to where it was originally, as if the feature had not 
been removed, but the feature itself will not be added back on. 
Thus, the program buffer will be shrunk, but you will not have the 
feature. In short, be careful that you do not try to remove a 
feature that has already been removed. 

The shortened BASIC created by the FEATURES program may be saved ona 
newly initialized diskette for use as a BASIC-only diskette. Follow 
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the procedure in Appendix B before you exit from BASIC, in order to 
do this. 

The shortened BASIC can also be saved on your Personalized MDOS 
System Diskette, or a copy of it. To do this, type the following 
lines after BASIC'S "READY" prompt, with the desired system disk in 
drive (each line is followed by depressing return) : 

OPEN 1 "BASIC" :ATTRS(1)=0 
SCRATCH "BASIC" 
SAVE "BASIC" 16R1572, 16R5DFP 
ATTRS(1)=16RP: CLOSE 1 

Following the last line, your system diskette has a copy of the 
shortened version of- BASIC, which will be used everytime you enter 
the command BASIC . You can use the DISKCOPY command in MDOS to copy 
this sytem diskette. 

If you do not save your shortened BASIC in one of these ways, then 
since it only exists in the system's memory, it will be lost when 
you turn the power off or return to MDOS. Until then, you can use 
it for programming in BASIC. 
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APPENDIX H ~ IMTERFJkCIMG TO A CENTRONICS PRINTER 



Centronics Printer 



VECTOR GRAHIEC ERBTTER INTERFACE 



General 



The Vector Graphic Printer Interface provides the means to connect a Centronics 
line printer such as the 700 series of printers or equivalent to the Vector M2 
or other Vector Grajfaic microccnputers. The interface is designed to utilize 
the Vector Graphic Bit Streamer I/O board parallel ports via connection to one 
input port and one CMtput port. 

The software driver program iwDnitors the HJSY signal from the printer arri v^en 
the printer is not KBY {BUSY=0) the program may transfer a character of data at 
which time the printer BDSY signal goes true thus holding off data transnission 
until the printer is once again ready to accept data. 



I/O gORT BIT ASSIGNMEOTS 
PORT 01 OOTPOT 



BIT 


7 


6 


5 


4 


3 


2 


1 







STROBE 


DATA 
6 


DATA 
5 


DATA 
4 


3 


DATA 
2 


DATA 
1 


MSA 



PORT 


01 INPOT 


BIT 


7 


6 


5 


4 


3 


2 


1 




BCSY 
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IHTERFACE PARIS LIST 

1 ea Serial I/O cable (Bit Streamer to Vector MZ tsackpanel. 
1 ea Printer cable (Vector MZ backpanel to printer) 

1 ea 6 pin Molex connector. 



INSTALLATION INSTKUCTIONS 



CAOTICN - Power must be off before proceeding with installation. 

1. Bit streamer I/O Board 

a) Cut the circuit trace at J3-19. 

b) Add a short junper wire from J3-19 to J2-17. 

c) Add the 6 pin Molex connector on the circuit or back side 
of the board as shown in Figure 1. 

d) Install the Bit Streamer in a chassis slot near the back 
panel of the computer chassis. 

e) PliQ in the 24 pin dip plug {part of the I/O cable) into J3 of 
the Bit Streaner. If ^ur canputer does not have this cable 
(Vector P/U 10-1327) one imist be obtain«3. 

2. Serial I/O Cable 

a) Install t±e serial I/O cable in the Vector MZ with the 25 pin 
connector attached in an available cutout on the rear panel 
and connect the 6 pin Molex plug to the Bit Streamer as 
shown in Figure 1. This now becanes the connector to use with 
your terminal (Hazel tine, etc) , 
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CABLE WISE LIST AND DIAGRAM 



viCTcm m/CTmMMics i/o cable 



Jl 


J2 


CENTRONICS 


COMPOTER 




VECTOR MZ 


CENi'MMCCS 


SIC3NAL NAME 


SIGHAi NAME 
port 01 bit 




6 


11 


BUSY 


IN 


25 


7 


DATA 6 


port 01 bit 


5 OUT 


24 


6 


DATA 5 


port 01 bit 


4 OUT 


16 


3 


DATA 2 


port 01 bit 


1 OUT 


15 


4 


DATA 3 


port 01 bit 


2 OUT 


17 


2 


DMA 1 


port 01 bit 


OUT 


12 


8 


DATA 7 


port 01 bit 


6 OUT 


14 


5 


DATA 4 


port 01 bit 


3 OUT 


11 


1 


STKDBE 


port 01 bit 


7 OUT 


7 


16 


GEDCJND 


- 





Jl 




J2 






1 = 120" 







DB-25P 



Amphenol 57-30360 

or equiv.. 
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CABLE WISE LIST AND DIM3RAM 



SERIAL I/O CABLE 



Jl 

1 

5 
6 



J2 

7 
3 
2 



SICSML NAME 

GSOUND 
TRA!®!IT DAIA 

RECEIVE DATA 






C=3 

cza 



J2 



=L 



1 » 12" 



6 Pin Molex 



DB-25S 
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llllllll Illlllll Illlllll 











I 

m q: 



in 



Mi 
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APPENDIX I - TROUBLE SHOOTING IF MDOS DOES NOT LOAD 

This section is applicable the first time you attempt to load MDOS 
using the Extended System Monitor B command. 

1) If the disk drive select light does not go on in response 
to command B, check the connection between the mainframe and the 
console. If this is not the problem, then the system requires 
attention by the dealer or by Vector Graphic, 

2) If the MDOS has not signed on within 20 seconds, but the 
disk drive select indicator light is still glowing, the bootstrap 
ROM has been unable to read the loader into memory from the 
diskette. Depress RESET. Check whether the correct diskette was 
inserted in the correct drive, that it is inserted facing correctly 
(label leftward or upward) , and that it is fully inserted and fully 
mounted (snapped into place). If not the problem, inspect the 
diskette for obvious contamination or damage. Reload the diskette 
and begin again with the Monitor B command. 

3) If the system has not signed on but the unit select 
indicator has extinguished, the loader may not have been able to 
read the rest of the system into memory. The probable cause is a 
malfunctioning memory chip. Use the Extended Systems Monitor 
command N to test memory. (See the Extended Systems Monitor 
manual.) If this test terminates at a value below C000H (i.e. 48K) , 
it indicates malfunctioning memory: The ending address is the 
location of the malfunction. If N reveals no problem, then try 
command T, a more thorough memory test. Use the ending address 
given by command N, less 1, as the second address in the command T 
argument, and use 0000 as the first address. To use an Extended 
System Monitor command, depress RESET on the front panel of the 
mainframe. Then enter the command you want, after the Monitor 
prompt * appears. 

4) If there is no problem with memory, the system requires 
attention by a service representative. 
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APPEND!! J - GAMES AND DISPLAYS ON THE MDOS SYSTEM DISKETTE 



STARTREKG, CIVILWAR, and LUNAR are games written in BASIC. 
BASIC, then enter: 

PLOADG 'Kgame name>" (return). 



Get into 



The games are self-explanatory, with the exception of STARTREKG. 
STARTREKG uses the classic set of rules familiar to all computer 
Start rek aficlanados. For others, a little trial and error gets the 
player going. 

FINANCE is a BASIC program for computing various Interest and 
annuity problems. It is useful on a day-to-day basis for users 
working with investment problems. Its operation is 
self-explanatory. To start it, use the PLOADG command as with 
games, above. 

PLASH? is a demonstration of the graphics capability of the 
Flashwriter II board. Do not attempt to use it unless your system 
uses this board, indicated by 80 X 24 display on a video monitor or 
Mindless Terminal. Also, it will not work If the system is set up 
to run word-processing (i.e. it is a MEMORITE II system, or the Word 

have been installed on 

if the system has the 

PROM'S Which are installed when MZ 



Management System character generator PROM's 
the Flashwriter II board.) It will only work 
graphics character generator 
systems are manufacturerd. 



To use PLASH7, mount ' an MDOS System diskette in drive 0. Get into 
the MDOS command mode (usually done by depressing B (return) after 
turning on or reseting the machine.) Then type PLASH? (return) . 
The program will begin executing, showing off the many features of 
the Flashwriter II board, including graphics, lack of glitches on 
screen, multiple cursors, reverse video, and so on. The program 
will execute Indefinitely by repeating Itself until halted by the 
operator with the RESET botton. This program is an excellent demo 
for dealers. (Dealers who want to demo Word Management System on 
the same system must forego it, however.) 

The operator may interact with PLASH? (unlike the earlier PLASH6) in 
various ways. First, touching the space bar at most times will 
freeze the screen, for closer examination. Another space bar will 
resume the demo. Second, the operator can cause the demo to jump 
directly to any of several points within its cycle, if that 
particular part of the demo is of special interest. This is 
accomplished by pressing one of the following letters at almost any 
time while the demo is operating: 



letter part of demo 



letter 



c 


Character Set 


B 


R 


Sphere 


L 


G 


Gettysburg Address 


S 


D 


Darth Vader 





part of demo 

Introducing System B 
Higher Level Languages 
Bubble Sort 
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APPENDIX K - CHANGING MICROPOLIS BOOTSTRAP ROM AND DISK I/O 
ADDRESSES 



The disk Bootstrap ROM and Disk Controller I/O addresses are 
located in the IK block from the base address D800 to DBFF. 



rs on the disk 
command in the 



The user may change this location by changing jumpe 
controller board. If this is done, however, the B Cuuuuanu m i.nc 
Extended Systems Monitor will no longer function, unless the new 
base address is P400, If not, in place of B, the operator must use 
the G command followed by the new base address. 

No software changes are necessary. Disk I/O routines in the RES 
module automatically find the disk controller and Bootstrap 
addresses. 

This is also true if the CP/M operating system is used. However, 
the MEMORITE and Word Management System word processing software, 
and the MZOS operating system, can only function with the disk 
controller and Bootstrap block beginning at the normal D800 
location. 

Use the following procedure to change the location of the block: 

1, Refer to figure K.l, locate the base address desired and 
determine the jumpers required. 

2. Referring to figure K.2, locate the address jumper 
locations on the controller board. Vector Graphic ships the board 
with jumpers Wl and W4 installed. 

3. Remove one or both of the installed jumpers and replace 
with jumpers required for the desired address. Use short lengths of 
wire, a 25-30 watt soldering iron, and resin-core solder. To avoid 
blowing LSI chips with static electricity, do not work in a carpeted 
room. Touch the contacts on the board edge with one hand before 
beginning to solder. 
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BASE ADDRESS 



STANDARD 
ADDRESS 



CO 
C4 
C8 
CC 
DO 
04 
08 
DC 
EO 
£4 
E8 
EC 
FO 
F4 
F3 
FC 



00 - C3FF 
00 - C7FF 
00 - CBFF 
00 - CFFF 
00 - D3FF 
00 - D7FF 
00 - OBFF 
00 - OFFF 
00 - E3FF 
00 - E7FF 
00 - EBFF 
00 - EFFF 
00 - F3FF 
00 - F7FF 
00 - FBFF 
00 - FFFF 





ADDRESS BIT 




A15 A14 
N/A 


JUMPER 
A13 A12 An 
Wl W2 W3 


AlO 
W4 


A9 A8 
"N/A 






























1 













1 
















1 


1 










1 
















1 





1 










1 


1 













1 


1 


1 































1 












1 















] 


1 









1 















1 





1 









1 


1 












1 


1 


1 






JUMPER INSTALLED 



Ml 


W2 


W3 


W4 


Y 


Y 


Y 


Y 


Y 


Y 


Y 


N 


Y 


Y 


N 


Y 


Y 


Y 


N 


N 


Y 


N 


Y 


Y 


Y 


N 


Y 


N 


Y 


H 


N 


Y 


Y 


N 


H 


N 


N 


Y 


Y 


Y 


N 


Y 


Y 


N 


N 


Y 


N 


Y 


N 


Y 


N 


N 


N 


N 


Y 


V 


N 


N 


Y 


H 


N 


N 


N 


Y 


N 


N 


N 


N 



As an example, if you wish to use base address F400 install jumper at W3. 



FigureK.I Controller Base Address Jumper Configurations 
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APPENDIX L - CHANGING CLOCK RATE TO 2 MHz 

To operate the system at 2 MHz speeds, a jumper must be removed from 
the disk controller board, as follows: 

1) Refer to figure L.l. Locate the ribbon cable edge connector 
and the resistors R25, R6 and R7. 

2) Between R25 and R6 is a jumper location, W9 . Remove the 
jumper there with a 25-30 watt soldering iron. To avoid 
blowing LSI chips with static electricity, do not work in a 
carpeted room. Touch the contacts on the board edge with one 
hand before beginning to solder. 

A jumper must then be added to the Z-80 board at location "A". 
Location "A" will be found under the top row of chips, directly 
under the third chip from the left, U3. If necessary, refer to the 
figure found in the 2-8i Board User's Manual. 
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Figure L.l Locatinq the controller processor speed jumper 
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APPENDIX M - WRITING A CONSOLE PHYSICAL I/O ROUTINE 

For users wishing to replace the console physical driver in the 
Vector Graphic Extended Systems Monitor, this section describes the 
console I/O requirements of the RES module. 

Your version should be written In place of the routines in RES. I/O 
found from lines 2250 to 2540. RES. I/O is the source code for the 
I/O routines in the RES module. It will be found on your MDOS 
System Diskettes. The listing is in Appendix E. 

If there are any other routines to rewrite, such as printer 
routines, do this before assembling RES. I/O. To assemble RES. I/O 
refer to Appendix where the procedures are explained. 

1) Lines 720 - 750 in the §CIOABLE can be changed if required. 

2) The logical input, output and break check routines {CIN, 
COUT, and CBRK) should not have to be changed. They are 
tailored to support all MDOS and BASIC requirements. 

3) The console physical input routine (COIN) must have the 
following characteristics: 

a) It must return all registers except A & B unchanged. 

b) It can use the A register (destroy it) . 

c) It must return an ASCII character including the parity bit 
if any, in the B register. 

d) It must return the carry flag clear (NC). The other 
status flags can be in any state. 

4) The console physical output routine (CDOUT) must have the 
, following characteristics: 

a) It must take an ASCII character in the B register. 

b) It must return all registers except A unchanged. 

c) It can use the A register (destroy it) . 

d) It must return the carry flag clear (NC) . 

e) The other status flags can be in any state. 

5) The console physical break check routine (CDBRK) must have 
the following characteristics: 

a) It must check the console input status port to determine 
if a key has been pressed. 

b) If no key has been pressed it must return all registers 
except A unchanged and the zero flag clear (NZ) . 

c) If a key has been pressed it must return the byte, in the 
B register. The A register can be used (destroyed). All 
other registers must be unchanged. The zero flag must be 

S @ u \ <i^ / • 

d) The status flags other than zero can be in any state. 

6) It will probably not be necessary to change the Physcial 
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Console Device Initialize routine (CDINIT) 
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APPENDIX N - WRITING A PRINTER PHYSICAL I/O ROUTINE 

This Appendix is used when you want to write a custom version of the 
printer physical I/O routines in the RES module. 

1) RES. I/O is an assembly language source code file found on the 
MDOS System Diskettes. In order to rewrite any part of the 
I/O routines in the RES module, rewrite the relevent portions 
of this source file, using the Line Editor in MDOS. Note 
that RES. I/O is not the source file for the entire RES 
module, but only the I/O portion of it. 

2) Write the your printer driver routine beginning at line 3470 
in the RES. I/O. Make sure the contents of lines 3520-3540 
are at the end of your routine. The first line must use the 
label L01, not LDOUT. Do not over-write the other printer 
physical I/O routines in the Source code (only yours will be 
assembled, as you will see.) The parts of the new routine 
must have the following characteristics: 

a) The character to be output is passed to the physical 
output routine in the B register in ASCII. 

b) The physical output routine can use (destroy) the A 
register. 

c) All registers except A must be returned unchanged, 

d) Some printers can signal when paper is out, the motor is 
off, or they are out of ribbon. The system supports 
printers which can signal a PRINTER ATTENTION condition. 
If the printer needs attention, the physical output 
routine should return with the carry flag set (C) . If 
your printer does not support a printer attention 
condition, then always return with the carry clear (NC) . 
The other status flags can be returned in any state, 
LDATN, the routine which handles printer attention, must 
not destroy any registers except A. 

3) Lines 890-920 in the gLIOTABLE can be changed if desired. 

4) The present contents of lines 3520 - 3540 must be at the end 
of your routine, or it will not assemble. 

5) Turn to Appendix when you are ready to assembly and save 
the new RES module. 
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jyppmPIX - REASSEMBLING AND SAVING THE RES MODULE 

Follow the procedure in this appendix after you have modified the 
RES. I/O source code using the Line Editor in MDOS. When you are 
done with this appendix, the RES module program will be modified on 
your MDOS System Diskette, and ready to use. 

1) Mount Personalized MDOS System Diskette in Drive 0. 

2) In MDOS, enter ZSM "RES. I/O" "ORES" "E" (return) . 

3) Four questions will appear on the screen one after the other. 
Your answers to these questions tell the assembler which 
printer driver to include in the assembled code. Your 
choices will be a standard Diablo protocol driver, a standard 
Centronics protocol driver, a standard Decwriter and Teletype 
protocol driver, or a driver you have written yourself 
according to the instructions in Appendix N. As each 
question appears, depress a if you do not want that driver, 
or a 1 if you do. Answer 1 to only one of the questions, and 
to the other three. If you did not write your own and are 
not sure vrfiich of the three standard drivers you need, review 
section 2.2 in Chapter 2 which includes examples of the 
different types of printers. 

. 4) After the fourth question, another question will appear on 
the screen, asking "Bit streamer base address?" The answer to 
this question is if the Bitstreamer board is jumpered to 
respond to port #'s 0, 1, 2, and 3, and it is 4 if the 
Bitstreamer board is jtimpered to respond to port #'s 4, 5, 6, 
and 7. Generally, the former is the case if you are using a 
serial terminal such as a Hazeltine, and the latter is the 
case if you are using a Flashwriter board to interface a 
memory-mapped terminal such as Vector Graphic's Mindless 
Terminal or a memory -mapped video monitor such as a Hitachi. 
(If for some reason you have chosen to jumper the Bitstreamer 
board for a different set of port #'s, then respond with the 
lowest # of the set you are using.) 

5) After the last question, the object code will be assembled. 
At the end of the assembly , the message "END = XXXX" will 
appear. This value must be under 0700. If it is not, then 
the routines you have written are too long, and must be 
shortened . 

6) At this point, with the code successfully assembled, the new 
I/O portion of the RES module is on disk as a temporary file 
called "GRES" but not yet overlayed over the entire RES 
module on the system diskette. To do this, enter TYPE "CRES" 
C (return) . and then CRES (return) . Finally, type SCRATCH 
"CRES" (return) to clear this workfile from the disk. 

7) The complete RES module with all changes is now in memory, 
but not yet stored on disk. Debug it now. Proceed when it 
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is finalized. 

8) To save the new RES module, follow the instructions in 
Section 2.2.0 of this manual. 

10) NOTE: Do not overlay one of the pre-written printer drivers 
as instructed in Chapter 2, sections 2.2.1 and 2.2.2. Steps 3 
and 4 above already installed the correct driver. 
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APPENDIX P - MAP OF I/O PORTS 

On the following page you will find a chart which lists all the I/O 
ports that an 8080 or Z80 can address, in hexadecimal notation. An 
I/O port is accessed when the processor executes an IN xx or OUT xx 
instruction, where xx is the one of the port numbers in the chart. 
The port number will appear on the lower half of the address bus 
instead of a memory address, and either SINF or SOUT will be active 
high which tells memory NOT to react and tells I/O devices that it 
is their turn. Each I/O device and board has gating circuitry which 
detects when its own port nximber is on the bus. Usually, I/O 
devices have dip-switches or jtmper pads with which you can assign 
any port number. 

Next to some of the ports, you will fir^d the names of commonly used 
boards which respond to those port numbers. Some of these boards 
are Vector Graphic's and some are not. In the case of the Vector 
Graphic boards, most of them can be assigned ANY port number, either 
by dip-switch or jumper. The numbers shown for these boards are 
those that Vector Graphic software expects. Use this information to 
avoid present and future conflict when you are assigning port 
numbers to hardware. You can also use this sheet as a worksheet if 
you are assigning a ntjmber of ports. 
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APPENDIX Q - MEMORY DIAGNOSTICS 

MDIAG 

If you have some reason to suspect that the computer's main memory 
is tnalfxinctioning, use the Memory Diagnostic program on the MDOS 
System Diskette. Simply turn the system on, mount the system 
diskette in drive (the right-hand drive) , type B following the 
Monitor prompt (*) , type ffllAG following the MDOS prompt (>) , then 
depress the RETURN key. The program will load into the scratch-pad 
area of memory (not part of main memory) and execute. 

MDIAG tests the contiguous memory beginning at 0000. There are 
actually two tests going on at the same time. Each repetition 
("pass") of the program fills the next 8K block of memory with 
random numbers, and then tests it for changes. At the same time, it 
also fills all of memory with a certain fill code, and then tests 
all of it for changes. A display appears showing the result of each 
repetition. The program waits a certain "delay time" after filling 
before it tests memory. After all 8K blocks of main memory have 
been tested, the delay time is increased, and the program repeats 
beginning with 0000. 

The display shows for each repetition the TOP OF MEMORY (the lowest 
address which is not in main memory), ACTIVE BLOCK (the first 
address of the 8K block currently subject to the random number 
test), the PASS NUMBER (incremented after each repetition), the FILL 
CODE (the code used to fill all of main memory as the second part of 
the test), the DELAY TIME currently being used, the number of ERRORS 
READ, and an ERROR DUMP showing the last 10 errors encountered, 
giving the address which malfunctioned, the code written, and the 
code read . 

MDIAG will run indefinitely, with ever increasing delay times, if 
allowed to. It is used at the factory to burn the systems in for 
long periods of time. To stop it, depress the RESET key. 

Monitor T Command 

The T memory test is part of the Extended Systems Monitor PROM which 
comes in the system. To activate it, depress the RESET key, then 
type T, followed by the beginning address (in hex) of the block you 
want to test, then the ending address of the block. For example, to 
test the 48K of main memory, type T 0000 BFFF . The program will 
begin executing immediately. 

The program stores random numbers into memory, then tests to see if 
any have changed. If memory is perfect, you will see nothing on the 
screen. However, if anything changes, the program displays the 
address, the code written, and the code read back. Then it 
continues testing. It will go on until stopped by depressing the 
RESET key. 

Comparing with MDIAG, the strengths of the "T" test are 1) it allows 
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you Co cast porcions of memory which are aoc concisuous begianiag ac 
0000, for example an SK, block from EQQO co FFFF. or che screen 
memory, normally from DOQO Co D7FF; 2) ic displays ALL Che errors, 
rather Chan che Lasc 10, allowing you co pinpoint all malftiaccioning 
locacions, and 3) you can use ic wichouc.disk drives, if needed. 

The weaknesses are 1) it may not show up errors produced by dynamic 
memory over a delay time longer Chan T uses, whereas MDIAG increases 
che delay cime to long enough intervals j and 2) you muse know che 
ending address of memory. MDIAG is considered Che faeccer Cesc for 
dynamic memories, which are used in Che standard Vector Graphic 
systems. 

Monitor N coTTmand ,^ "*"~"' ~ ■- -■— Z """--■ 

N is a non-destructive memory test. To activate it, _ depress the 
RESET key, then type H. It will make only one pass -through memory, 
temporarily storing~each byte, testing whether 00 and FF can be 
stored and recalled correctly, and then replacing the original 
contents. It does 'this until an error is found, whereupon it prints 
the address, the code written, and the code recalled, and then 
returns to the Monitor executive. 

This program is most useful for determining how much main m«mory a 
given system has, because if no errors are found, it will print out 
cha first addrasa of SOM memory which is above main memory. The U 
test is aoc nearly as thorough as either the T test or MDIAG, and it 
only reports the first error fotind. However, it allows you to test 
memory without destroying any_ of the contents, unlike che others. 

HAP 

MA? is a utility which tells you whether SAM, ROM or no memory ac 
all, is at each address in the system. This includes all special 
purpose memory such as video boards, scratch-pad, and so on. Use 

HA? if you are not sura what is in the system. If che syscam is 
standard, then the result should be the same as che map in Figure 
1.2 (Chapter 1), with the PRCMs appropriate for your configuration. 

To run MA?, simply turn the system on, mount the system diskette in 
drive (che right-hand drive), type B following the Monitor prompt- 
(*), C7pe_HAP followiag the MDOS proarot (>), the depress .che RSTOM 
key. '"The progra will load and execute. The resultant display is a' 
matrix of memory that is fairly self-explanatory. You only have co 
know that the addresses increase from l*eft to right in blocks of TOO 
Hex (256 bytes). Tou can run MA? with SAM holding data or program 
without losing anything; it is a non-destructive test, except for 
the area it uses itself, which is the scratch-oad area beginning 
from DCOQ to DOFF. 
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